【Conda】配置Conda镜像源

Conda 镜像源配置指南
适用系统：Windows 10（含 Miniconda / Anaconda） & Linux（Ubuntu / CentOS / Debian 等）

---

1. 为什么要设置镜像源

在中国大陆直接访问 repo.anaconda.com 经常遇到速度慢、连接超时、SSL 错误等问题。把默认源替换为国内镜像，可提升 5-20 倍下载速度。

---

2. 通用思路

1. 找到 Conda 的配置文件 .condarc
   • Windows：C:\Users\<用户名>\.condarc
   • Linux：~/.condarc（即 /home/<用户名>/.condarc）
2. 修改或新建 .condarc，写入镜像通道地址。
3. 清除索引缓存，验证生效。

---

3. 一键命令行配置（推荐）

打开 终端（Win：Anaconda Prompt / PowerShell；Linux：bash/zsh），复制粘贴即可。

3.1 清华镜像（最常用）

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 --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch
conda config --set show_channel_urls yes

如你使用的是 PyTorch、TensorFlow 等特定框架，建议额外添加它们的专用镜像通道，例如：

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch

3.2 中科大镜像

conda config --add channels https://mirrors.ustc.edu.cn/anaconda/pkgs/main
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/pkgs/free
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/conda-forge
conda config --set show_channel_urls yes

3.3 阿里云镜像

conda config --add channels https://mirrors.aliyun.com/anaconda/pkgs/main
conda config --add channels https://mirrors.aliyun.com/anaconda/pkgs/free
conda config --add channels https://mirrors.aliyun.com/anaconda/cloud/conda-forge
conda config --set show_channel_urls yes

---

4. 手动编辑 .condarc（备用方案）

如果命令行修改失败，可手动创建/编辑文件，内容如下：

channels:- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free- https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge- https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch- defaults
show_channel_urls: true

保存后关闭即可。

---

5. 验证是否成功

conda config --show channels

应看到类似输出：

channels:- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free- ...

---

6. 清理缓存（确保立即生效）

conda clean -i

---

7. 恢复默认官方源

conda config --remove-key channels

---

8. 常见问题 FAQ

问题	解决方案
CondaHTTPError / SSLError	检查公司/校园网代理，或改用 HTTP 镜像（如 http:// 而非 https://）。
镜像未生效	确认 .condarc 路径正确，未存在同名文件冲突。
找不到特定包	添加对应 cloud 频道，例如 conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/bioconda。

---

9. 附录：常用镜像列表

镜像源	主页	说明
清华大学	https://mirrors.tuna.tsinghua.edu.cn/help/anaconda/	最全，更新快
中国科技大学	https://mirrors.ustc.edu.cn/anaconda/	稳定
北京外国语大学	https://mirrors.bfsu.edu.cn/help/anaconda/	教育网友好
阿里云	https://developer.aliyun.com/mirror/anaconda	企业网络友好