推荐使用pip config set命令永久配置阿里云镜像源，因其延迟低、同步及时且兼容主流pip版本；若命令不可用则手动创建%APPDATA%\pip\pip.ini文件配置；临时安装可用-i参数指定源并配--trusted-host。

pip 默认走境外源，国内直连经常卡在 Connection timed out 或长期停留在 Downloading...。直接换国内镜像源是最有效、最轻量的解法，不用装代理、不改系统网络设置，改完立竿见影。

用 pip config set 一键永久生效（推荐）

这是 2026 年最稳妥的方式，兼容 pip ≥ 21.3（当前主流版本都满足），且不会因路径/编码/权限问题失败。

执行这两行命令即可：

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
pip config set global.trusted-host mirrors.aliyun.com

阿里云源目前在全国多数地区延迟最低、同步最及时；清华源虽有名气，但近期偶发目录结构变更导致某些包 404。

• 如果提示 No such key: global.index-url，先升级 pip：python -m pip install --upgrade pip
• trusted-host 必须配，否则 HTTPS 证书校验失败时会报 CertificateError
• 配置后立即生效，无需重启终端或重装 Python

手动创建 pip.ini 文件（Windows 用户备用方案）

当 pip config 命令不可用（比如旧版 pip 或权限受限环境），就走文件配置。

路径必须严格为：%APPDATA%\pip\pip.ini（不是 %USERPROFILE%\pip，后者在部分 Windows 版本下无效）。

• 按 Win + R → 输入 %APPDATA% → 回车，进入 Roaming 目录
• 新建文件夹 pip，再在里面新建文本文档，重命名为 pip.ini（确保扩展名不是 .txt）
• 文件内容只写这三行，不能多空行、不能用 UTF-8-BOM 编码：

[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
trusted-host = mirrors.aliyun.com

常见坑：用记事本保存时默认是 ANSI 编码，但若用 VS Code 或 Notepad++ 保存，务必选 UTF-8 without BOM，否则 pip 读取失败且无明确报错。

立即学习“Python免费学习笔记（深入）”；

python全能编程助手

SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、

下载

临时换源：单次安装不污染全局

适合测试某个包是否真在镜像里、或公司内网策略禁止改全局配置时。

命令格式固定，-i 和 --trusted-host 必须成对出现：

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

• 中科大源地址已更新为 https://pypi.mirrors.ustc.edu.cn/simple/，旧教程里的 https://pypi.ustc.edu.cn/simple/ 已失效
• 豆瓣源仍可用，但同步频率下降，新发布的包可能延迟 6–12 小时
• 不要混用多个 -i，pip 不支持 fallback 镜像机制，只认最后一个

验证是否生效 & 排查失败原因

改完别猜，直接看结果。

运行 pip config list，输出里应有：

global.index-url='https://mirrors.aliyun.com/pypi/simple/'
global.trusted-host='mirrors.aliyun.com'

如果仍走官方源，检查：

• 是否在虚拟环境中？pip config 默认改的是当前环境，不是 base 环境
• 是否存在冲突配置：执行 pip config debug 查看所有配置文件加载路径
• 某些 IDE（如 PyCharm）自带 pip wrapper，需在设置里单独指定镜像源，不继承系统配置

真正容易被忽略的是：镜像源本身不解决依赖解析慢的问题——如果 pip install torch 卡在 Resolving dependencies...，换源没用，得换 uv 或加 --no-deps 手动装。