直接换国内镜像源即可解决pip安装慢问题,因默认访问境外pypi.org服务器导致跨境网络延迟;临时用-i参数指定清华或阿里等镜像源(需带/simple后缀),永久配置则修改pip.ini(Windows)或pip.conf(Linux/macOS)文件,并设置trusted-host。

直接换国内镜像源就能解决,不是 pip 本身慢,是默认走的 https://pypi.org/simple 境外服务器,DNS 解析、TCP 连接、TLS 握手全卡在跨境链路上。
临时生效:加 -i 参数最保险
每次安装都带上镜像地址,不依赖任何配置,适合 CI/CD、Docker 构建或临时调试环境:
-
pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple(清华源,更新快、稳定) -
pip install torch -i https://mirrors.aliyun.com/pypi/simple/(阿里源,对大包如torch、tensorflow更友好) - 必须带
/simple后缀,否则会报404 Client Error - 如果提示
WARNING: The repository located at pypi.tuna.tsinghua.edu.cn is not a trusted host,补上--trusted-host:pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn
永久配置:Windows 下改 pip.ini,Linux/macOS 下改 pip.conf
避免每次敲一堆参数,但要注意路径和文件名不能错:
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
- Windows:在
%APPDATA%\pip\pip.ini(即C:\Users\用户名\AppData\Roaming\pip\pip.ini)中写入:
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn
- Linux/macOS:在
~/.pip/pip.conf中写入(目录和文件需手动创建):
[global] index-url = https://mirrors.aliyun.com/pypi/simple/ trusted-host = mirrors.aliyun.com
- 不要用记事本直接另存为
pip.ini—— 它可能偷偷加 BOM 头,导致 pip 读取失败;推荐用 VS Code、Notepad++ 或echo命令生成 - 配置后运行
pip debug -v,看输出里active index urls是否已变成你填的地址
PyCharm 里 pip 安装慢?别只改命令行,IDE 内部也要同步
PyCharm 默认用自己的 pip 环境,即使命令行已配好镜像,IDE 仍可能走默认源:
- 打开
File → Settings → Project → Python Interpreter - 点右上角
+→ 左下角Manage Repositories… - 删掉默认的
https://pypi.org/simple/,新增一行:https://pypi.tuna.tsinghua.edu.cn/simple - 点 OK 后,再点刷新按钮(?),否则新源不会立即生效
- 如果装
opencv或pytorch还卡住,说明它们在清华源里没及时同步,可临时切到阿里源重试
最容易被忽略的是:镜像源不是万能的。有些包(比如私有库、GitHub 直链的 pip install git+https://...)完全不走 index-url,这时候再快的镜像也无效;还有部分包(如 torch 的 CUDA 版本)官方只放在自己的 CDN,必须用其指定链接安装——这种场景下,得靠 --find-links + 本地缓存,或者直接下载 .whl 文件离线装。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










