【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

9. 附录：常用镜像列表