Python Anaconda 与 Pip 配置清华镜像源指南

为 Anaconda 设置清华源可以极大地提升软件包下载和更新的速度。以下是详细的步骤，分为两个主要部分：为 conda 本身设置频道镜像和为 pip 设置索引镜像。

方法一：通过命令行快速设置（推荐）

这是最快捷的方法，通过执行几条命令即可完成。

1. 打开终端（Windows 用 Anaconda Prompt，Mac/Linux 用 Terminal）。

验证配置： 执行以下命令查看当前的配置，确认 channels 里已经都是清华源的地址。

conda config --show channels 

（可选但推荐）移除默认的官方频道： 为了避免 conda 在官方源和清华源之间来回切换，可以移除默认的 defaults 频道。

conda config --remove channels defaults 

设置搜索时显示频道地址：

conda config --set show_channel_urls yes

依次执行以下命令，添加清华的 conda 频道镜像： 这些命令会修改你的 ~/.condarc 文件（Linux/Mac）或 %USERPROFILE%\.condarc 文件（Windows）。

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

注意：从 2019 年 4 月起，Anaconda 官方建议使用 defaults 和 conda-forge 频道。清华源镜像也同步了这些频道。实际上，通常只需要添加 main, free 和 conda-forge 这几个核心频道即可满足大部分需求。

方法二：手动编辑配置文件

你也可以直接创建或修改 conda 的配置文件。

1. 找到配置文件：
   • Linux/Mac: ~/.condarc
   • Windows: C:\Users\<你的用户名>\.condarc
2. 用文本编辑器（如 Notepad++, VS Code）打开该文件，如果不存在就新建一个。
3. 保存文件。

将以下内容复制到文件中：

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/msys2/
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/bioconda/
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/menpo/
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/
  - defaults
show_channel_urls: true
default_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
custom_channels:
  conda-forge: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  msys2: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  bioconda: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  menpo: 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
  simpleitk: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud

这个配置比命令行方式更全面，它同时设置了常规频道和自定义频道的映射。

为 Pip 设置清华源

当你使用 pip install 命令时（尤其是在 conda 环境中），它默认从 PyPI 下载，速度可能依然很慢。同样可以为 pip 设置清华源。

临时使用：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple some-package 

永久设置：

1. Windows：
   • 在用户目录（如 C:\Users\<你的用户名>\）下创建一个名为 pip 的文件夹。
   • 在该文件夹内创建一个名为 pip.ini 的文件。
2. Linux/Mac：
   • 在用户目录（~）下创建 .pip 文件夹：mkdir ~/.pip
   • 创建配置文件 ~/.pip/pip.conf。

输入以下内容并保存：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn

验证和使用

完成以上设置后，你可以尝试安装或更新一个包来测试速度。

# 例如，更新 conda 自身
conda update conda
# 或者安装一个包，如 numpy
conda install numpy 

你应该能看到下载地址来自 mirrors.tuna.tsinghua.edu.cn，速度会有显著提升。

注意事项

• 清除索引缓存：如果更换源后遇到问题，可以尝试清除 conda 的缓存：conda clean -i。
• 恢复默认源：如果需要，可以删除 .condarc 文件，或者使用 conda config --remove-key channels 命令来恢复默认设置。
• 源地址更新：镜像地址有时会变更，请关注 清华 TUNA 镜像站 Anaconda 帮助页面 以获取最新信息。