更换国内镜像源可解决PyPI下载慢问题,推荐使用阿里云、清华、中科大等镜像;可通过pip命令临时指定源或配置文件永久生效,Windows在%USERPROFILE%\pip\pip.ini,Linux/macOS在~/.pip/pip.conf中设置index-url和trusted-host,也可用pip config set命令快速配置。

在国内使用默认的 PyPI 源安装 Python 包时,常会遇到下载慢、连接超时等问题。解决方法是将 pip 的包源更换为国内镜像站点,提升下载速度和稳定性。以下是几种常用的设置方式。
常用国内镜像源地址
以下是国内稳定且更新频繁的镜像源,可直接用于替换默认源:
- 阿里云: https://mirrors.aliyun.com/pypi/simple/
- 清华大学: https://pypi.tuna.tsinghua.edu.cn/simple/
- 中国科技大学: https://pypi.mirrors.ustc.edu.cn/simple/
- 豆瓣: https://pypi.douban.com/simple/
- 华为云: https://mirrors.huaweicloud.com/repository/pypi/simple/
临时使用镜像源安装包
如果只是偶尔想加速某个包的安装,可以在 pip 命令中通过 -i 参数指定镜像源:
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ numpy
这种方式无需修改配置,适合临时使用。
立即学习“Python免费学习笔记(深入)”;
永久配置镜像源(推荐)
永久设置后,每次使用 pip 都会自动从指定镜像下载,无需重复输入参数。
Windows 系统:- 进入用户目录,如:
C:\Users\你的用户名\ - 创建文件夹:
pip(若不存在) - 在该文件夹内创建文件:
pip.ini - 写入以下内容(以清华源为例):
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple/ trusted-host = pypi.tuna.tsinghua.edu.cnmacOS / Linux 系统:
- 进入用户主目录:
~/.pip/(若不存在则创建) - 创建并编辑配置文件:
~/.pip/pip.conf - 添加如下内容:
[global] index-url = https://mirrors.aliyun.com/pypi/simple/ trusted-host = mirrors.aliyun.com
注意:trusted-host 是为了允许不带 HTTPS 验证的主机,部分源需要配置。
使用 pip config 命令快速设置
也可通过命令行直接设置全局配置:
pip config set global.index-url https://pypi.mirrors.ustc.edu.cn/simple/
这条命令会自动生成配置文件并写入设置,简单快捷。
基本上就这些。换源后,安装包速度明显提升,尤其对大型库如 numpy、pandas、pytorch 等效果显著。建议选择一个稳定源并长期使用。配置不复杂但容易忽略。










