国内pip和conda安装Python包常因访问国外源超时失败,换用清华等国内镜像源可大幅提升速度与成功率;支持临时参数(如-i)和永久配置两种方式,conda还可通过命令或编辑.condarc定制。

在国内使用 pip 和 conda 安装 Python 包时,常因连接国外服务器超时、卡死或反复失败而中断安装,尤其在校园网、企业内网或移动宽带环境下更明显;换用国内镜像源后,下载速度可从几 KB/s 提升至 5–20 MB/s,且成功率接近 100%。
临时切换 pip 源(单次安装生效)
这一步操作起来很简单,直接在 pip install 命令末尾加 -i 参数即可,无需修改任何配置文件。
执行命令:pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple/
清华源地址必须以 /simple/ 结尾,少一个斜杠会导致 404 错误,无法识别包列表。
其他可用临时源地址(任选其一):
豆瓣源:-i http://pypi.douban.com/simple/
阿里云源:-i https://mirrors.aliyun.com/pypi/simple/
中科大源:-i https://pypi.mirrors.ustc.edu.cn/simple/
永久设置 pip 源(推荐新手首选)
Windows 用户只需一条命令就能完成永久配置,比手动建文件更可靠,且自动适配当前用户权限路径。
第一步:以管理员身份打开 CMD 或 PowerShell,运行:
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/
第二步:追加可信主机配置,避免 HTTPS 证书校验报错:
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn
第三步:验证是否写入成功:
pip config list
如果看到输出中包含 index-url 和 trusted-host 两行对应值,说明已生效。下次执行 pip install 不再需要加 -i 参数。
通过命令行添加 conda 镜像源(无须编辑文件)
方法一:逐条添加主流清华通道(最稳妥,兼容旧版 conda)
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 --set show_channel_urls yes
【注意】执行完所有 add 命令后,conda 会自动按添加顺序降序排列通道优先级,最新添加的排最前——所以务必最后加 conda-forge 这类高频更新源。
手动配置 conda 的 .condarc 文件(适合多源定制)
如果已存在 C:\Users\你的用户名\.condarc 文件,直接用记事本打开并替换全部内容;若不存在,先运行 conda config --set show_channel_urls yes 自动生成。
将以下内容完整复制进 .condarc(注意缩进必须为英文空格,不能用 Tab):
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/
show_channel_urls: true
保存后关闭文件,无需重启终端,下一次 conda 命令即刻生效。
验证是否成功:conda config --show channels,输出应列出上述三个 URL 地址。











