PyCharm中pip install默认走官方源,因其使用独立虚拟环境的pip且不读取系统pip.conf;需在Settings→Python Interpreter→Manage Repositories中添加并置顶国内镜像源(如清华源),新项目还需配置New Projects Settings才生效。

PyCharm里pip install还是走默认源?先确认是不是IDE在用自己独立的pip
PyCharm默认会为每个项目创建独立的虚拟环境,并用自己的pip执行安装。你终端里改了全局镜像,对PyCharm没用——它压根不读你shell里的pip.conf或pip install -i参数。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 打开 File → Settings → Project → Python Interpreter(macOS 是 PyCharm → Preferences → Project → Python Interpreter)
- 点右上角
+添加包时,下方有Install Package按钮左侧的齿轮图标 → 选Show All→ 选中当前解释器 → 点右下角Show Details,能看到实际调用的pip路径,确认是不是虚拟环境里的那个 - 如果列表里包加载极慢、或点
Install Package后卡住,基本就是还在连https://pypi.org/simple/
在PyCharm设置里直接填镜像源URL(最稳,无需动命令行)
PyCharm 2021.2+ 支持在UI里直接指定pip源,比改配置文件更可靠,也不依赖系统pip配置。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 进 Settings → Project → Python Interpreter
- 点右上角齿轮 →
Manage Repositories… - 点
+添加,填国内常用镜像,例如:https://pypi.tuna.tsinghua.edu.cn/simple/(清华)https://pypi.mirrors.ustc.edu.cn/simple/(中科大) - 添加后,**把新源拖到列表最上方**——PyCharm按顺序尝试,只认第一个可用源
- 删掉默认的
https://pypi.org/simple/,避免fallback失败还耗时
为什么改了Settings里的源,新建项目还是连官方源?
PyCharm的仓库设置是「每项目生效」的,不是全局策略。新项目默认继承模板设置,而默认模板里没预设镜像源。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 新建项目前,先去 Settings → New Projects Settings → Settings for New Projects → Project Interpreter
- 点右侧齿轮 →
Manage Repositories…,把镜像源加进去并置顶 - 这样所有后续新建项目都会自动带上这个源,不用每个项目重复配
- 注意:已存在的项目不会自动更新,得单独进各自Settings里配
pip install命令行仍慢?检查PyCharm是否绕过了你的~/.pip/pip.conf
即使你在系统级配了pip.conf,PyCharm调用pip时可能传了--no-cache-dir或--find-links等参数,导致忽略配置;也可能虚拟环境里pip版本太老(如pip < 20.3),不支持index-url的配置项解析。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 在PyCharm的Terminal里运行:
pip config list -v,看输出里有没有global.index-url或site.index-url - 如果没输出,说明当前
pip没读到配置;可手动写:pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/ - 但更推荐优先用前面说的UI方式管理源——不依赖pip版本,也不受
--no-cache-dir干扰
真正容易被忽略的是:PyCharm的「Package Installer」和「Terminal」走的是两套逻辑。一个配好了,另一个未必同步。别只测一个地方就以为全通了。










