1. 为什么每个Python开发者都该学会给conda换源刚装完Anaconda的那几天大概是每个Python新手最兴奋也最崩溃的阶段。兴奋的是终于有了一个能管理各种科学计算库的环境崩溃的是——conda install numpy敲下去进度条卡在Solving environment转圈圈一转就是十几分钟最后还可能给你来个CondaHTTPError: HTTP 000 CONNECTION FAILED。这不是你的网络有问题而是conda默认的软件源服务器在国外国内访问速度慢、连接不稳定是常态。我见过太多人在这一步放弃转而去用pip结果pip默认源同样慢得让人抓狂。其实解决办法非常简单把conda的软件源换成国内的镜像站。换完之后原本要等十分钟的包通常几十秒就能下完Solving environment的卡顿也会明显改善。这篇内容就是把我这些年给不同机器、不同系统换源的经验整理出来从原理到实操从Windows到macOS再到Linux手把手带你走一遍。不管你是刚装完Anaconda的新手还是用了几年的老手只要你的conda下载速度还没跑满带宽这篇都值得看完。核心关键词就三个Anaconda、镜像源、conda。搞懂这三个词之间的关系后面所有操作你都能自己推导出来而不是死记命令。2. 换源之前先把conda的源这件事搞明白2.1 conda的源到底是什么为什么默认那么慢conda在安装包的时候会去一个叫channel频道的地方找包。默认情况下它会去repo.anaconda.com这个官方服务器找。这个服务器在国外国内访问要经过多个网络节点延迟高、丢包率高所以你会感觉特别慢甚至直接超时失败。打个比方这就像你要去图书馆借书但图书馆在城市的另一头路上还堵车。国内镜像源做的事情就是在你家门口开了一个分馆书还是那些书但走过去只要五分钟。镜像站会定期从官方源同步所有包所以你下载到的内容和官方的完全一致只是速度快了很多。国内常用的conda镜像源主要有几个我列个表对比一下方便你选镜像源运营方特点适用场景清华TUNA清华大学同步快、覆盖全、文档详细首选绝大多数情况够用中科大USTC中国科学技术大学同步及时、稳定性好清华偶尔抽风时的备选阿里云阿里巴巴企业级带宽、速度快企业环境或对速度要求高上海交大上海交通大学教育网内速度快校园网用户我个人的习惯是配置两个源主用清华备用中科大。这样万一某个源临时同步出问题conda会自动去另一个找不至于卡死。2.2 换源到底改的是哪个文件很多人换源失败根本原因是改错了文件。conda的配置分两个层级全局配置位于~/.condarcLinux/macOS或C:\Users\你的用户名\.condarcWindows。这个文件对所有conda环境生效。环境级配置位于具体环境目录下一般不用动。我们要改的就是那个.condarc文件。这个文件默认可能不存在需要你手动创建。它的格式是YAML缩进敏感写错了conda会直接报错。注意网上有些教程让你去改pip.ini或者pip.conf那是给pip换源的跟conda是两码事。conda和pip是两个独立的包管理器源也要分别配置。很多人只换了pip的源然后纳闷为什么conda install还是慢就是这个原因。2.3 换源能解决什么不能解决什么换源能解决的是下载速度慢、连接超时、Solving environment卡顿这几类问题。但它解决不了包本身不存在于镜像源极少数冷门包你的网络本身有问题比如公司防火墙限制conda版本太老导致的依赖解析bug所以换源是第一步但不是万能药。后面我会讲遇到这些情况怎么排查。3. 手把手实操三大系统换源全流程3.1 Windows下给Anaconda换源最详细版Windows用户最多坑也最多我一步步来。第一步找到.condarc文件的位置打开Anaconda Prompt不是普通的cmd输入conda config --show-sources如果输出里有 C:\Users\你的用户名\.condarc 说明文件已存在。如果没有说明还没创建我们下一步手动建。第二步用命令生成配置文件在Anaconda Prompt里依次执行下面几条命令这是最不容易出错的方式conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/ conda config --set show_channel_urls yes这几条命令的意思是把清华的三个主要频道加到配置里并且让conda在下载时显示包来自哪个URL方便你确认换源成功。第三步手动编辑.condarc推荐命令方式虽然简单但有时候会残留默认源。我更推荐直接编辑文件。用记事本打开C:\Users\你的用户名\.condarc把内容替换成channels: - defaults show_channel_urls: true default_channels: - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2 custom_channels: conda-forge: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud pytorch: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud pytorch-lts: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud nvidia: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud这里有个关键点default_channels覆盖了默认的官方源custom_channels则把conda-forge、pytorch这些常用第三方频道也指向了清华镜像。这样你装pytorch的时候就不用额外配置了。提示YAML文件对缩进极其敏感必须用空格不能用Tab。冒号后面要有一个空格。写完后保存编码选UTF-8。第四步清理缓存并验证换源后一定要清缓存否则conda可能还在用旧的索引conda clean -i conda clean -a然后验证conda config --show channels输出应该显示你配置的清华源。再随便装个包试试conda install requests如果下载URL显示的是mirrors.tuna.tsinghua.edu.cn恭喜你成功了。3.2 macOS和Linux换源几乎一样macOS和Linux的操作基本一致因为都是类Unix系统。第一步确认conda已初始化先执行conda --version如果提示command not found说明conda没加到PATH里。这时候需要先初始化~/anaconda3/bin/conda init zsh或者如果你用的是bash~/anaconda3/bin/conda init bash执行完必须重启终端或者执行source ~/.zshrc或~/.bashrc让配置生效。这一步很多人漏掉然后一直报conda: command not found。第二步编辑.condarc用你顺手的编辑器打开vim ~/.condarc内容跟Windows那节一样直接复制过去。如果没有这个文件vim会新建一个。第三步验证conda config --show-sources conda clean -i conda install numpy看下载地址是不是镜像站即可。3.3 换源后的第一次完整测试换完源别急着干活先做个完整测试确认各个环节都正常。我一般会跑这么一套# 查看当前配置 conda config --show channels # 清理索引缓存 conda clean -i # 创建一个测试环境 conda create -n test_env python3.10 -y # 激活环境 conda activate test_env # 装一个稍大的包测试速度 conda install numpy pandas -y # 退出并删除测试环境 conda deactivate conda env remove -n test_env这一套跑下来如果创建环境在1分钟内完成装numpypandas在2分钟内完成说明你的源配置得很健康。如果还是慢往下看排查部分。4. 换源踩坑实录这些问题我全遇到过4.1 换了源还是慢甚至报CondaHTTPError这是最常见的问题。原因通常有三个原因一缓存没清。conda会缓存索引文件换源后如果不清缓存它可能还在用旧的索引去连官方源。解决conda clean -i。原因二.condarc里有残留的默认源。用conda config --show-sources看看如果输出里还有repo.anaconda.com说明没清干净。手动编辑.condarc删掉。原因三SSL证书问题。有些公司网络会拦截HTTPS导致证书验证失败。临时解决办法是在.condarc里加ssl_verify: false但这会降低安全性只建议在内网环境临时用。更好的办法是把公司的根证书加到系统信任列表里。4.2 conda activate报错run conda init before conda activate这个报错跟换源没直接关系但换源过程中经常遇到因为很多人换完源重启终端就报这个。原因是shell没有加载conda的初始化脚本。解决办法conda init然后关闭终端重新打开。如果还不行检查你的shell配置文件~/.bashrc、~/.zshrc里有没有conda init添加的那段代码。没有的话手动加上# conda initialize __conda_setup$(/home/你的用户名/anaconda3/bin/conda shell.bash hook 2 /dev/null) if [ $? -eq 0 ]; then eval $__conda_setup fi # conda initialize 4.3 镜像源同步延迟导致装不到最新版镜像站不是实时同步的通常有几小时到一天的延迟。如果你要装一个刚发布的新版本包镜像源可能还没有。这时候有两个选择临时用官方源装conda install -c https://repo.anaconda.com/pkgs/main 包名等一天再装我一般不急的话就等急的话临时切官方源装完再切回来。4.4 常见问题速查表问题现象可能原因解决办法下载速度没变化缓存未清/配置未生效conda clean -i重启终端CondaHTTPError网络/证书/源地址错检查.condarc临时关ssl_verifyconda command not found未初始化shellconda init后重启终端Solving environment卡死依赖冲突/源不全换conda-forge源或指定版本装pytorch找不到包未配置pytorch频道在custom_channels加pytorch换源后pip还是慢pip源没换单独配置pip.conf/pip.ini提示这张表建议截图存手机里下次遇到直接对照能省很多搜索时间。5. 进阶技巧让conda用起来更顺手5.1 pip也要一起换源别只换condaconda和pip经常混用只换conda的源pip还是慢。pip换源很简单Linux/macOS创建~/.pip/pip.conf[global] index-url https://pypi.tuna.tsinghua.edu.cn/simple trusted-host pypi.tuna.tsinghua.edu.cnWindows创建C:\Users\你的用户名\pip\pip.ini内容一样。这样conda和pip双管齐下装什么都快。5.2 环境迁移时怎么保留源配置换电脑或者重装系统时.condarc文件直接复制过去就行。但要注意路径里的用户名要改。我习惯把配置文件存到网盘换机器直接拉下来。5.3 多环境下的源管理如果你有很多conda环境全局的.condarc对所有环境生效一般够用。但有时候某个环境需要特殊的源比如内网私有源可以在该环境目录下建一个.condarc它会覆盖全局配置。这个技巧在企业内网开发时特别有用。5.4 定期更新conda本身换源之后conda自身的更新也会走镜像快很多conda update -n base conda建议每隔一两个月跑一次保持conda版本较新能避免很多依赖解析的bug。6. 我这些年换源攒下的几条经验第一条别迷信某一个源。清华源虽然好但偶尔也会同步出问题或者临时维护。我电脑里常年配着清华主源中科大备源一个不行自动切另一个几乎没再遇到过下载失败。第二条换源后第一件事是清缓存。这个我强调三遍了因为真的太重要。很多人换完源发现没效果90%是缓存没清。第三条.condarc用编辑器改别用命令堆。命令方式虽然快但容易残留默认源而且不好排查。手动编辑文件内容一目了然出问题也好定位。第四条Windows用户一定要用Anaconda Prompt。普通cmd里conda可能不在PATH里会报各种奇怪的错。Anaconda Prompt是专门配置好环境的省心。第五条遇到问题先看报错里的URL。conda的报错信息里会显示它尝试连接的地址如果那个地址是repo.anaconda.com说明你的源根本没生效回去检查.condarc。如果地址是镜像站但还是失败那就是网络或证书问题方向就清楚了。最后分享一个我自己的小习惯每次在新机器上装完Anaconda第一件事就是换源第二件事是跑一遍conda create -n test python3.10测试。这两步做完后面装什么环境都顺。别等到装pytorch卡了半小时才想起来换源那时候心情已经不好了。提前五分钟配置省下的是后面无数次的等待。
1. 为什么每个Python开发者都该学会给conda换源刚装完Anaconda的那几天大概是每个Python新手最兴奋也最崩溃的阶段。兴奋的是终于有了一个能管理各种科学计算库的环境崩溃的是——conda install numpy敲下去进度条卡在Solving environment转圈圈一转就是十几分钟最后还可能给你来个CondaHTTPError: HTTP 000 CONNECTION FAILED。这不是你的网络有问题而是conda默认的软件源服务器在国外国内访问速度慢、连接不稳定是常态。我见过太多人在这一步放弃转而去用pip结果pip默认源同样慢得让人抓狂。其实解决办法非常简单把conda的软件源换成国内的镜像站。换完之后原本要等十分钟的包通常几十秒就能下完Solving environment的卡顿也会明显改善。这篇内容就是把我这些年给不同机器、不同系统换源的经验整理出来从原理到实操从Windows到macOS再到Linux手把手带你走一遍。不管你是刚装完Anaconda的新手还是用了几年的老手只要你的conda下载速度还没跑满带宽这篇都值得看完。核心关键词就三个Anaconda、镜像源、conda。搞懂这三个词之间的关系后面所有操作你都能自己推导出来而不是死记命令。2. 换源之前先把conda的源这件事搞明白2.1 conda的源到底是什么为什么默认那么慢conda在安装包的时候会去一个叫channel频道的地方找包。默认情况下它会去repo.anaconda.com这个官方服务器找。这个服务器在国外国内访问要经过多个网络节点延迟高、丢包率高所以你会感觉特别慢甚至直接超时失败。打个比方这就像你要去图书馆借书但图书馆在城市的另一头路上还堵车。国内镜像源做的事情就是在你家门口开了一个分馆书还是那些书但走过去只要五分钟。镜像站会定期从官方源同步所有包所以你下载到的内容和官方的完全一致只是速度快了很多。国内常用的conda镜像源主要有几个我列个表对比一下方便你选镜像源运营方特点适用场景清华TUNA清华大学同步快、覆盖全、文档详细首选绝大多数情况够用中科大USTC中国科学技术大学同步及时、稳定性好清华偶尔抽风时的备选阿里云阿里巴巴企业级带宽、速度快企业环境或对速度要求高上海交大上海交通大学教育网内速度快校园网用户我个人的习惯是配置两个源主用清华备用中科大。这样万一某个源临时同步出问题conda会自动去另一个找不至于卡死。2.2 换源到底改的是哪个文件很多人换源失败根本原因是改错了文件。conda的配置分两个层级全局配置位于~/.condarcLinux/macOS或C:\Users\你的用户名\.condarcWindows。这个文件对所有conda环境生效。环境级配置位于具体环境目录下一般不用动。我们要改的就是那个.condarc文件。这个文件默认可能不存在需要你手动创建。它的格式是YAML缩进敏感写错了conda会直接报错。注意网上有些教程让你去改pip.ini或者pip.conf那是给pip换源的跟conda是两码事。conda和pip是两个独立的包管理器源也要分别配置。很多人只换了pip的源然后纳闷为什么conda install还是慢就是这个原因。2.3 换源能解决什么不能解决什么换源能解决的是下载速度慢、连接超时、Solving environment卡顿这几类问题。但它解决不了包本身不存在于镜像源极少数冷门包你的网络本身有问题比如公司防火墙限制conda版本太老导致的依赖解析bug所以换源是第一步但不是万能药。后面我会讲遇到这些情况怎么排查。3. 手把手实操三大系统换源全流程3.1 Windows下给Anaconda换源最详细版Windows用户最多坑也最多我一步步来。第一步找到.condarc文件的位置打开Anaconda Prompt不是普通的cmd输入conda config --show-sources如果输出里有 C:\Users\你的用户名\.condarc 说明文件已存在。如果没有说明还没创建我们下一步手动建。第二步用命令生成配置文件在Anaconda Prompt里依次执行下面几条命令这是最不容易出错的方式conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/ conda config --set show_channel_urls yes这几条命令的意思是把清华的三个主要频道加到配置里并且让conda在下载时显示包来自哪个URL方便你确认换源成功。第三步手动编辑.condarc推荐命令方式虽然简单但有时候会残留默认源。我更推荐直接编辑文件。用记事本打开C:\Users\你的用户名\.condarc把内容替换成channels: - defaults show_channel_urls: true default_channels: - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2 custom_channels: conda-forge: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud pytorch: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud pytorch-lts: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud nvidia: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud这里有个关键点default_channels覆盖了默认的官方源custom_channels则把conda-forge、pytorch这些常用第三方频道也指向了清华镜像。这样你装pytorch的时候就不用额外配置了。提示YAML文件对缩进极其敏感必须用空格不能用Tab。冒号后面要有一个空格。写完后保存编码选UTF-8。第四步清理缓存并验证换源后一定要清缓存否则conda可能还在用旧的索引conda clean -i conda clean -a然后验证conda config --show channels输出应该显示你配置的清华源。再随便装个包试试conda install requests如果下载URL显示的是mirrors.tuna.tsinghua.edu.cn恭喜你成功了。3.2 macOS和Linux换源几乎一样macOS和Linux的操作基本一致因为都是类Unix系统。第一步确认conda已初始化先执行conda --version如果提示command not found说明conda没加到PATH里。这时候需要先初始化~/anaconda3/bin/conda init zsh或者如果你用的是bash~/anaconda3/bin/conda init bash执行完必须重启终端或者执行source ~/.zshrc或~/.bashrc让配置生效。这一步很多人漏掉然后一直报conda: command not found。第二步编辑.condarc用你顺手的编辑器打开vim ~/.condarc内容跟Windows那节一样直接复制过去。如果没有这个文件vim会新建一个。第三步验证conda config --show-sources conda clean -i conda install numpy看下载地址是不是镜像站即可。3.3 换源后的第一次完整测试换完源别急着干活先做个完整测试确认各个环节都正常。我一般会跑这么一套# 查看当前配置 conda config --show channels # 清理索引缓存 conda clean -i # 创建一个测试环境 conda create -n test_env python3.10 -y # 激活环境 conda activate test_env # 装一个稍大的包测试速度 conda install numpy pandas -y # 退出并删除测试环境 conda deactivate conda env remove -n test_env这一套跑下来如果创建环境在1分钟内完成装numpypandas在2分钟内完成说明你的源配置得很健康。如果还是慢往下看排查部分。4. 换源踩坑实录这些问题我全遇到过4.1 换了源还是慢甚至报CondaHTTPError这是最常见的问题。原因通常有三个原因一缓存没清。conda会缓存索引文件换源后如果不清缓存它可能还在用旧的索引去连官方源。解决conda clean -i。原因二.condarc里有残留的默认源。用conda config --show-sources看看如果输出里还有repo.anaconda.com说明没清干净。手动编辑.condarc删掉。原因三SSL证书问题。有些公司网络会拦截HTTPS导致证书验证失败。临时解决办法是在.condarc里加ssl_verify: false但这会降低安全性只建议在内网环境临时用。更好的办法是把公司的根证书加到系统信任列表里。4.2 conda activate报错run conda init before conda activate这个报错跟换源没直接关系但换源过程中经常遇到因为很多人换完源重启终端就报这个。原因是shell没有加载conda的初始化脚本。解决办法conda init然后关闭终端重新打开。如果还不行检查你的shell配置文件~/.bashrc、~/.zshrc里有没有conda init添加的那段代码。没有的话手动加上# conda initialize __conda_setup$(/home/你的用户名/anaconda3/bin/conda shell.bash hook 2 /dev/null) if [ $? -eq 0 ]; then eval $__conda_setup fi # conda initialize 4.3 镜像源同步延迟导致装不到最新版镜像站不是实时同步的通常有几小时到一天的延迟。如果你要装一个刚发布的新版本包镜像源可能还没有。这时候有两个选择临时用官方源装conda install -c https://repo.anaconda.com/pkgs/main 包名等一天再装我一般不急的话就等急的话临时切官方源装完再切回来。4.4 常见问题速查表问题现象可能原因解决办法下载速度没变化缓存未清/配置未生效conda clean -i重启终端CondaHTTPError网络/证书/源地址错检查.condarc临时关ssl_verifyconda command not found未初始化shellconda init后重启终端Solving environment卡死依赖冲突/源不全换conda-forge源或指定版本装pytorch找不到包未配置pytorch频道在custom_channels加pytorch换源后pip还是慢pip源没换单独配置pip.conf/pip.ini提示这张表建议截图存手机里下次遇到直接对照能省很多搜索时间。5. 进阶技巧让conda用起来更顺手5.1 pip也要一起换源别只换condaconda和pip经常混用只换conda的源pip还是慢。pip换源很简单Linux/macOS创建~/.pip/pip.conf[global] index-url https://pypi.tuna.tsinghua.edu.cn/simple trusted-host pypi.tuna.tsinghua.edu.cnWindows创建C:\Users\你的用户名\pip\pip.ini内容一样。这样conda和pip双管齐下装什么都快。5.2 环境迁移时怎么保留源配置换电脑或者重装系统时.condarc文件直接复制过去就行。但要注意路径里的用户名要改。我习惯把配置文件存到网盘换机器直接拉下来。5.3 多环境下的源管理如果你有很多conda环境全局的.condarc对所有环境生效一般够用。但有时候某个环境需要特殊的源比如内网私有源可以在该环境目录下建一个.condarc它会覆盖全局配置。这个技巧在企业内网开发时特别有用。5.4 定期更新conda本身换源之后conda自身的更新也会走镜像快很多conda update -n base conda建议每隔一两个月跑一次保持conda版本较新能避免很多依赖解析的bug。6. 我这些年换源攒下的几条经验第一条别迷信某一个源。清华源虽然好但偶尔也会同步出问题或者临时维护。我电脑里常年配着清华主源中科大备源一个不行自动切另一个几乎没再遇到过下载失败。第二条换源后第一件事是清缓存。这个我强调三遍了因为真的太重要。很多人换完源发现没效果90%是缓存没清。第三条.condarc用编辑器改别用命令堆。命令方式虽然快但容易残留默认源而且不好排查。手动编辑文件内容一目了然出问题也好定位。第四条Windows用户一定要用Anaconda Prompt。普通cmd里conda可能不在PATH里会报各种奇怪的错。Anaconda Prompt是专门配置好环境的省心。第五条遇到问题先看报错里的URL。conda的报错信息里会显示它尝试连接的地址如果那个地址是repo.anaconda.com说明你的源根本没生效回去检查.condarc。如果地址是镜像站但还是失败那就是网络或证书问题方向就清楚了。最后分享一个我自己的小习惯每次在新机器上装完Anaconda第一件事就是换源第二件事是跑一遍conda create -n test python3.10测试。这两步做完后面装什么环境都顺。别等到装pytorch卡了半小时才想起来换源那时候心情已经不好了。提前五分钟配置省下的是后面无数次的等待。
