Python Anaconda 换源：设置清华源

优质文章学习记录

25 Nov 2025 — 4 min read

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

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

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

打开终端（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 的配置文件。

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

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

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:truedefault_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

永久设置：

Windows：
- 在用户目录（如 C:\Users\<你的用户名>\）下创建一个名为 pip 的文件夹。
- 在该文件夹内创建一个名为 pip.ini 的文件。
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

用记事本打开，输入以下内容并保存：

[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 帮助页面以获取最新信息。