背景

pip 默认从 PyPI 下载包，服务器在海外，国内下载速度经常只有几十 KB/s，甚至超时。换成国内镜像源可以跑满带宽，下载体验提升很明显。

pip 源的三种配置方式

1. 临时指定（单次生效）

在 install 命令后面加 -i 参数：

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

适合偶尔用一次的场景，不需要改任何配置文件。

2. pip config 命令（推荐）

直接通过命令行写入配置，不用手动找文件位置：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

这条命令会自动写入对应平台的配置文件：

平台	配置文件路径
Linux / macOS	~/.config/pip/pip.conf
Windows	%APPDATA%\pip\pip.ini

验证是否生效：

pip config list

3. 手动编辑配置文件

Linux / macOS — 编辑 ~/.config/pip/pip.conf：

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

Windows — 编辑 %APPDATA%\pip\pip.ini，内容同上。

某些 Linux 发行版也可以放在 ~/.pip/pip.conf 或 /etc/pip.conf，但 ~/.config/pip/pip.conf 是 pip 官方推荐的路径。

常用国内镜像源

名称	地址
清华大学	https://pypi.tuna.tsinghua.edu.cn/simple
阿里云	https://mirrors.aliyun.com/pypi/simple
中国科学技术大学	https://pypi.mirrors.ustc.edu.cn/simple
腾讯云	https://mirrors.cloud.tencent.com/pypi/simple
华为云	https://repo.huaweicloud.com/repository/pypi/simple
豆瓣	https://pypi.douban.com/simple

清华和阿里云更新最及时，日常使用首选。

常见问题

配了源但下载还是慢

有些包不一定在镜像源上，或者镜像同步有延迟。可以临时切回官方源：

pip install some-package -i https://pypi.org/simple

提示 SSL 证书错误

部分旧系统或内网环境可能遇到证书问题，临时解决（不推荐长期使用）：

pip install some-package --trusted-host pypi.tuna.tsinghua.edu.cn

更好的做法是更新系统 CA 证书或设置 CURL_CA_BUNDLE 环境变量。

只想给当前用户生效

pip config set 默认就是用户级别。如果想全局生效（所有用户），需要加 --site：

sudo pip config --site set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

怎么看当前用的是哪个源

pip config list

或者看某个包是从哪里下载的：

pip install --dry-run requests 2>&1 | grep -i 'from'

清华源建议去掉 /simple 吗

不需要。/simple 是 PEP 503 要求的 Simple Repository API 路径，pip 需要这个路径才能正确解析包列表。配置时地址末尾带 /simple 是正确的写法。

总结

配置 pip 源就是一行命令：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

配好后所有 pip install 自动走镜像，不用每次都加 -i。如果某个包下载有问题，临时指定官方源或换个镜像源即可。