换国内镜像源即可解决PyCharm中pip安装慢问题,因默认访问境外pypi.org导致跨境网络延迟;需同步配置命令行(pip.ini/pip.conf)和PyCharm的Manage Repositories,删掉官方源并添加带/simple后缀的国内地址(如https://pypi.tuna.tsinghua.edu.cn/simple),且必须配置trusted-host。

PyCharm 里 pip 安装包慢,不是 pip 本身卡,是默认走 https://pypi.org/simple 这个境外源——DNS 解析、TLS 握手、TCP 建连全卡在跨境链路上。换国内镜像源就能立竿见影,但必须同步改命令行和 IDE 两处,否则只改一处照样慢。
PyCharm GUI 安装时仍走默认源?删掉官方源再加国内地址
PyCharm 的 Project Interpreter 界面用的是它自己维护的 pip 配置,和系统命令行互不干扰。即使你本地 pip 已配好清华源,IDE 里点“+”安装仍可能卡住。
- 打开
File → Settings → Project → Python Interpreter - 点右上角
+→ 左下角Manage Repositories… - 选中默认的
https://pypi.org/simple,点击-删除 - 点
+新增一行:https://pypi.tuna.tsinghua.edu.cn/simple(必须带/simple后缀) - 点
OK后,务必手动点窗口右上角的刷新按钮,否则新源不生效
如果提示 WARNING: The repository located at pypi.tuna.tsinghua.edu.cn is not a trusted host,说明没加 trusted-host —— 这时不能在 GUI 里填,得去改 pip 全局配置(见下一条)。
pip config set global.index-url 不生效?检查 pip.ini 路径和 BOM
Windows 下 pip 永久配置文件是 %APPDATA%\pip\pip.ini(即 C:\Users\用户名\AppData\Roaming\pip\pip.ini),Linux/macOS 是 ~/.pip/pip.conf。写错路径或文件编码,pip 就直接忽略。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- 不要用记事本新建并“另存为”
pip.ini—— 它会偷偷加 UTF-8 BOM 头,pip 读取失败 - 推荐用 VS Code、Notepad++ 或终端命令生成:
echo [global] > %APPDATA%\pip\pip.ini && echo index-url = https://pypi.tuna.tsinghua.edu.cn/simple >> %APPDATA%\pip\pip.ini && echo trusted-host = pypi.tuna.tsinghua.edu.cn >> %APPDATA%\pip\pip.ini - 配置后运行
pip debug -v,确认输出里active index urls已变成你填的地址 - 若用阿里源,
trusted-host必须写mirrors.aliyun.com,不是https://mirrors.aliyun.com
临时安装还报 404 或 SSL 错误?-i 参数必须带 /simple 和 --trusted-host
命令行临时换源最保险,适合 CI/CD 或调试环境,但漏掉任一参数都会失败:
-
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple—— 缺/simple后缀 → 404 -
pip install torch -i https://mirrors.aliyun.com/pypi/simple/—— 缺--trusted-host→ SSL 警告 + 被拒绝 - 正确写法:
pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn - 大包如
torch、tensorflow推荐用阿里源:pip install torch -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com
PyCharm 终端里 pip 还慢?确认它用的是项目解释器对应的 pip
PyCharm 底部 Terminal 默认激活的是当前项目的虚拟环境(如 venv),但该环境里的 pip 可能没继承全局配置。尤其用 python -m venv 创建的环境,pip 是干净的,没读取用户级 pip.ini。
- 先运行
which pip(macOS/Linux)或where pip(Windows),确认路径指向项目venv内的 pip - 再执行
pip config list,看是否显示 global 配置 —— 若无,说明该 pip 没加载用户配置 - 此时要么手动给 venv 里的 pip 单独配:
venv\Scripts\pip.exe config set global.index-url ... - 要么在 Terminal 里先激活 venv 再运行
pip install -i ...临时指定
真正容易被忽略的点:PyCharm 的 Python Interpreter 设置、系统 pip 配置、项目 venv 里的 pip 配置,三者是独立的。只改其中一处,其他地方照旧慢。

















