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