Python 3.6安装完成后怎么配置国内pip镜像源
详细讲解Python 3.6安装完成后配置国内pip镜像源的完整方法,涵盖命令行自动配置、跨平台手动修改配置文件、临时加速命令及老版本pip兼容避坑指南。
pip 工具安装第三方扩展包时,默认会连接官方的 PyPI 服务器(位于境外)。受限于跨国网络延迟和路由波动,下载速度经常只有几十 KB/s,甚至频繁出现 ReadTimeoutError 下载超时或中断。配置国内知名高校或企业维护的镜像源,是解决包下载缓慢最直接、最有效的方法。本文将系统讲解如何在 Python 3.6 环境下通过命令行一键永久配置、跨平台手动创建配置文件以及单次命令临时加速,并专门梳理 Python 3.6 这一特定版本在配置时容易遇到的兼容性与证书问题。
一、常用国内优质 pip 镜像源选择
国内有多家知名高校与大型云服务厂商为开源社区提供免费的 PyPI 镜像同步服务。这些镜像源通常每隔数分钟或每小时与官方源同步一次,并且部署了高带宽的国内 CDN 节点,能将下载速度从官方源的数十 KB/s 提升到数十 MB/s。
以下是经过长期检验、服务稳定可靠的国内主流 pip 镜像源地址:
| 镜像源机构 | 镜像完整地址(index-url) | 网络特点与建议场景 |
|---|---|---|
| 清华大学 (TUNA) | https://pypi.tuna.tsinghua.edu.cn/simple |
教育网与公网双栈高速直连,同步延迟低,高校与科研机构首选。 |
| 阿里云 (Aliyun) | https://mirrors.aliyun.com/pypi/simple/ |
全国 CDN 节点覆盖广泛,商业级带宽保障,企业及个人网络极速稳定。 |
| 腾讯云 (Tencent) | https://mirrors.cloud.tencent.com/pypi/simple/ |
华南及全国主要骨干节点响应极快,公网及腾讯云主机内网访问表现优异。 |
| 华为云 (Huawei) | https://repo.huaweicloud.com/repository/pypi/simple/ |
基础设施吞吐大,稳定可靠,适合高并发构建与生产部署环境。 |
| 中国科学技术大学 (USTC) | https://pypi.mirrors.ustc.edu.cn/simple/ |
历史悠久的老牌高校开源镜像站,网络访问平稳。 |
二、Python 3.6 环境现状与配置路径判断
在开始配置之前,必须先明确 Python 3.6 的运行环境特征。Python 3.6 默认自带的 pip 版本视具体的微版本和安装包打包形式而定:例如 Python 3.6.0 最初携带的是 pip 9.0.1,而后期更新的 3.6.8 可能携带 pip 18.x。同时,Python 3.6 能够升级到的最终支持版本为 pip 21.3.1。
这个版本分水岭决定了你的配置方式:
- pip 10.0 及以上版本:原生支持
pip config set命令,终端一行命令即可自动在系统标准路径下创建或修改配置文件。 - pip 9.x 及以下老版本:不支持
pip config子命令。如果直接运行会提示unknown command "config",此时需要采用手动创建配置文件的方法。
请首先在终端(Windows 下为 CMD 或 PowerShell,macOS/Linux 下为 Terminal)中执行以下命令检查 pip 版本:
python -m pip --version
如果输出结果形如 pip 21.3.1 from ... (python 3.6) 或 pip 18.1 ...,版本号高于 10.0,请直接采用下文的方法一(命令行自动配置);如果显示 pip 9.0.1 且暂时不想升级 pip,请采用方法二(手动创建配置文件)。
三、方法一:命令行一键永久配置(推荐,适用于 pip ≥ 10.0)
如果你的 pip 已经处于 10.0 或更高版本,pip 提供了原生配置文件管理命令。这一方法最为简便,能够避免用户手动建立文件夹和排查隐藏路径。
1. 设置国内主镜像源
在终端中执行以下命令,即可将全局默认的下载镜像设置为清华大学开源镜像站:
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
如果你希望使用阿里云镜像源,则执行:
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
2. 配置受信任域名与超时时间(推荐补充)
为了保证因网络抖动时不至于快速断开,建议将请求超时时长(默认 15 秒)调大至 60 秒;同时可将镜像站域名加入 trusted-host 白名单,避免部分系统出现 SSL 证书认证阻断:
pip config set global.timeout 60
pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn
3. 查看与确认配置结果
设置完成后,执行以下命令可以列出当前所有生效的配置项以及配置文件的实际存储路径:
pip config list -v
输出示例(以 Windows 平台为例):
For writing to C:\Users\Username\AppData\Roaming\pip\pip.ini:
global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'
global.timeout='60'
install.trusted-host='pypi.tuna.tsinghua.edu.cn'
四、方法二:跨平台手动创建配置文件(全版本通用)
如果当前 Python 3.6 环境下的 pip 版本较低(如 9.0.1),或者由于权限原因 pip config 无法写入,可以直接手动创建并编辑配置文件。这种方式是全平台通用的底层标准机制。
1. 确认不同操作系统的配置文件存储路径
- Windows 系统:
文件路径通常为:C:\Users\你的用户名\AppData\Roaming\pip\pip.ini
提示:可以直接在资源管理器地址栏输入%APPDATA%按回车,进入对应目录。若其中没有名为pip的文件夹,请手动新建该文件夹,然后在该文件夹内新建一个文本文件,重命名为pip.ini(注意确保文件扩展名不是pip.ini.txt)。 - Linux 系统:
文件路径通常为:~/.pip/pip.conf或~/.config/pip/pip.conf - macOS 系统:
文件路径通常为:~/.pip/pip.conf或$HOME/Library/Application Support/pip/pip.conf
2. 编写标准配置内容
打开或创建好对应的 pip.ini(Windows)或 pip.conf(Linux/macOS)文件后,使用文本编辑器将以下内容写入其中并保存:
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
timeout = 60
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn
[global]节点下的index-url:指定全局包索引基础地址,后续所有pip install都将优先从该地址拉取包索引。timeout:定义网络建立与数据传输的超时阈值(单位:秒),调高至 60 秒有助于在网络波动时防止大包传输中断。[install]节点下的trusted-host:声明受信任的主机名。如果在内网、公司代理或老旧系统根证书缺失时出现 SSL 校验阻断,该声明可确保安装顺利执行。
五、方法三:单次临时指定国内镜像源
如果你是在公共服务器上操作、不想修改全局环境变量,或者仅需临时安装一个特定的库进行验证,可以使用 -i(或 --index-url)参数单次指定镜像源。
python -m pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple
如果当前使用的源为 HTTP 协议,或者系统提示证书不信任,需要追加 --trusted-host 参数显式授权:
python -m pip install requests -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com
六、配置生效验证与结果排查
无论通过上述哪种方式完成配置,都应当进行一次实际的安装测试,以确保配置已被 pip 正常读取。
1. 快速验证测试
挑选一个体积小巧的轻量级包(例如 six)并在命令中加入 -v(详细输出模式)进行测试:
python -m pip install six -v
在控制台输出日志中,找到包含 Looking in indexes: 或 Downloading ... 的行。若显示的 URL 是你刚才配置的国内镜像域名(如 pypi.tuna.tsinghua.edu.cn),且下载速度在数秒内完成,则证明配置完全生效。
七、Python 3.6 环境特有的常见问题与避坑指南
由于 Python 3.6 属于历史稳定版本(官方早已结束维护),在配置镜像源和安装依赖包时,容易遇到新版 Python 不存在的特殊问题,请重点注意以下几点:
1. pip 提示 SSL 证书认证失败 (CERTIFICATE_VERIFY_FAILED)
原因分析:老版本的 Python 3.6 安装包自带的 OpenSSL 库或系统本地 CA 根证书已过期,当 pip 使用 HTTPS 连接国内镜像源时,无法验证对方的最新证书链。
解决办法:
- 在配置文件中必须显式添加
trusted-host = pypi.tuna.tsinghua.edu.cn,跳过对该域名的严格 SSL 验证。 - 在命令行中优先执行一次
python -m pip install --upgrade certifi -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn更新系统根证书。
2. 多 Python 版本并存时的 pip 指向混乱
原因分析:很多开发者的电脑上同时安装了 Python 2.7、Python 3.6 和 Python 3.10+。如果仅在终端中直接键入 pip install ...,调用的可能是系统全局环境变量中排在最前方的 pip,而非 Python 3.6 的 pip。
解决办法:始终通过解释器全路径或模块方式调用 pip,即:
python3.6 -m pip install <package>
或者直接使用绝对路径:
# Windows 示例
C:\Python36\python.exe -m pip install <package>
# Linux / macOS 示例
/usr/bin/python3.6 -m pip install <package>
3. Python 3.6 的 pip 最高支持版本上限
很多开发者在配置完镜像源后习惯性执行 pip install --upgrade pip。但在 Python 3.6 上,如果尝试升级到 pip 22 或更高版本,pip 会直接报错或者无法执行,因为 pip 21.3.1 是支持 Python 3.6 的最后一个版本。若需升级到该上限版本,应执行:
python -m pip install --upgrade "pip<=21.3.1"
八、总结
配置国内 pip 镜像源是搭建稳定高效 Python 3.6 开发环境的基础步骤。对于 pip 版本大于等于 10.0 的环境,优先运行 pip config set global.index-url <URL>;对于老版本 pip 或跨平台服务器运维,直接在 pip.ini 或 pip.conf 中固化配置最为稳妥。通过合理指定清华、阿里、华为或腾讯等主流云源,并配合 trusted-host 与解释器前缀调用规范,即可彻底告别下载慢、易超时的困扰。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









