跳转到主内容
新派编程网 - 新潮编程理念,全新技术课堂!

如何解决Python安装库太慢的问题_配置PyPI国内镜像源

pip安装慢的根源是默认连接海外PyPI服务器,换国内镜像源(如清华https://pypi.tuna.tsinghua.edu.cn/simple)可将速度从KB/s提升至MB/s,并消除超时;临时使用加-i参数,永久配置推荐pip config命令设置index-url和trusted-host。
pip
安装库慢,不是你网络差,也不是
pip
本身有问题,而是它默认连的是海外服务器
https://pypi.org/simple/
。换国内 镜像源 后,安装速度通常能从几 KB/s 提升到几 MB/s,超时错误基本消失。 临时用镜像源:单次安装不改配置 适合快速验证、CI 脚本或临时在别人机器上操作。直接加
-i
参数指定镜像地址即可,但要注意 HTTPS 证书问题。
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple
如果报
SSLError
或提示证书不可信,补上
--trusted-host
:
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn
阿里云源也常用:
pip install pandas -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com
注意:
-i
必须写在包名**之前**,顺序错会导致参数被当成包名解析 永久配置镜像源:一劳永逸生效 推荐用
pip config
命令设置,比手动建文件更可靠,且跨平台(Windows/macOS/Linux 都支持)。 执行命令设置清华源:
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
—— 输出里应包含上面两项 若想切回阿里云源,只需重复上述两行,把 URL 和 host 换成
https://mirrors.aliyun.com/pypi/simple/
和
mirrors.aliyun.com
手动创建 pip.ini / pip.conf 文件的坑 老教程常让你手建配置文件,但路径和格式错一个就白配。Windows 下最常见问题: Python 3.14.3 微软官方的 Python 扩展,是 VS Code 安装量最高的扩展(209M+)。集成 IntelliSense(通过 Pylance)、调试(通过 Python Debugger)、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。 下载 文件必须叫
pip.ini
(不是
.txt
),且保存为 UTF-8 无 BOM 编码 路径是
C:\Users\<用户名>\AppData\Roaming\pip\pip.ini
,不是
Program Files
或桌面 内容必须严格如下(空行、缩进、等号前后空格都影响解析):
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
Linux/macOS 对应路径是
~/.pip/pip.conf
,注意
~
是用户主目录,不是根目录 镜像源选哪个?别只看“快”,要看同步时效和稳定性 清华源和阿里云源目前更新最勤(每小时同步),中科大、腾讯云、华为云次之。豆瓣源偶尔掉链,不建议生产环境长期用。 立即学习 “ Python免费学习笔记(深入) ”; 清华源地址:
https://pypi.tuna.tsinghua.edu.cn/simple
(推荐新手首选) 阿里云源地址:
https://mirrors.aliyun.com/pypi/simple/
(企业内网兼容性略好) 别用 HTTP 地址(如
http://pypi.douban.com/simple
),现代 pip 默认禁用非 HTTPS 源,会直接报错 如果公司有私有 PyPI(比如 Nexus 或 Artifactory),优先配它,镜像源只是 fallback 配置本身很简单,真正容易忽略的是
trusted-host
这一行——很多用户配完发现还是 SSL 错误,就是因为漏了它。另外,
pip config
设置会覆盖手动文件,调试时建议先删掉旧的
pip.ini
再用命令重设。

相关文章