配置pip.ini使用镜像安装python扩展包

最新推荐文章于 2026-03-29 20:44:35 发布

原创最新推荐文章于 2026-03-29 20:44:35 发布 · 1.4k 阅读

1 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#python #pip #开发语言

本文介绍了在Windows 10系统中如何配置pip.ini以利用镜像源安装Python扩展包，并解决配置文件中出现的GBK字符错误。通过调整pip.ini的编码格式，设置extra-index-url和Trusted-host，以及将pip.ini路径添加到环境变量，可以成功避免警告并优化下载速度。

配置pip.ini使用镜像安装python扩展包

WIN10系统

1. 搜了几个帖子，需要稍微改动一下

然后加了注释，写了第一个 pip.ini ，如下：
保存时默认用了 UTF-8 格式
执行pip时，提示配置文件中包含非法的 cp936 字符。
cp936 指的就是 GBK。 ANSI 编码标准中第936页是GBK中文编码。
记事本默认用了 UTF-8。
在这里插入图片描述

删掉所有中文注释是一种解决办法。
其实把 pip.ini 改用 ANSI 格式保存也可以解决问题。

另外，
设置文件中的 extra-index-url ， Trusted-host 都只能存在1个。
所以，如果要设多个，用空格隔开就可以了。

在这里插入图片描述
配置文件中如果没设 Trusted-host 会出下述警告提示，但不影响下载安装。

加上 Trusted-host 以后，就可以避免警告信息了。
测试修改这个设置的过程中，还发现，
设置多个镜像地址，实际都是从最后一个镜像下载的。
大家可以试试看。

pip.ini 可以用这个：

[global]
index-url=https://pypi.mirrors.ustc.edu.cn/simple/
extra-index-url=https://pypi.mirrors.ustc.edu.cn/simple/ http://mirrors.aliyun.com/pypi/simple/

[install]
trusted-host=pypi.tuna.tsinghua.edu.cn pypi.mirrors.ustc.edu.cn mirrors.aliyun.com

2. 在环境变量里增加 pip.ini 所在目录

通常 pip.ini 都是放在 “c:\用户\xxx\pip\ 目录下。
在 win10 系统中，%USERPROFILE% 默认就是 c:\users\xxx
在这里插入图片描述
所以，
在用户的环境变量 Path 中，增加 %USERPROFILE%\pip 就可以了。
重启生效，用户变量 Path 的内容，会放到系统环境变量 Path 的后面。