pycharm 项目级镜像源需通过底部 python packages 面板→齿轮图标→manage repositories→+添加清华源(https://pypi.tuna.tsinghua.edu.cn/simple);全局配置更可靠,windows 执行 pip config set global.index-url ...,mac/linux 同理,且 terminal 中 pip 与图形界面配置相互独立。

PyCharm 默认走官方 PyPI 源(https://pypi.org/simple),在国内直连基本不可用——不是卡在 10KB/s,就是报 ReadTimeoutError 或 SSLError。必须配国内镜像源,否则连装个 requests 都要等三分钟。
PyCharm 项目级镜像源怎么加(2023.2.5+ UI)
新版 PyCharm 把入口藏得有点深,别再找 File > Settings > Project Interpreter 里那个“+”号弹窗了——它现在只管装包,不负责管源。
正确路径是:底部工具栏点开 Python Packages 面板 → 右上角齿轮图标 → Manage Repositories → 点 + 添加 URL。
- 推荐填
https://pypi.tuna.tsinghua.edu.cn/simple(清华源,同步快、CDN稳) - 命名建议写成
Tsinghua PyPI,方便识别 - 添加后立即生效,不用重启 IDE,但已打开的包安装弹窗需关闭重开才读新源
- 如果没看到
Python Packages面板,先去 Plugins 里确认是否启用了Python插件
pip 全局配置比 PyCharm 设置更可靠
PyCharm 的 Manage Repositories 只影响当前项目解释器的图形化安装行为;而命令行终端、脚本里调用 pip install、甚至某些插件后台安装,仍走系统级 pip 配置。所以优先配全局。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
Windows 用户执行:
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
这条命令会自动写入 %APPDATA%\pip\pip.ini,内容等效于:
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn
- 如果提示
PermissionError,说明你用的是管理员权限 CMD,换成普通用户终端再试 - Mac/Linux 用户对应命令是
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple,配置文件在~/.pip/pip.conf - 配完立刻生效,无需重启终端,但已激活的虚拟环境需重新
source bin/activate
遇到 SSL 错误或包找不到?先看这几个硬条件
镜像源不是万能的,有些问题出在配置之外:
-
SSLError常见于公司网络拦截 HTTPS,可临时改用 HTTP(如http://mirrors.aliyun.com/pypi/simple/),但仅限内网可信环境 - 某些新发布包(比如刚推上 PyPI 的 alpha 版)可能还没同步到镜像站,清华源每 15 分钟同步一次,阿里云标称“实时”,但仍有秒级延迟
- 如果装包时仍走
pypi.org,用pip debug -v查看实际使用的 index URL,确认没被pip.conf多层覆盖 - conda 环境用户注意:
conda install和pip install是两套机制,conda 镜像需单独配.condarc,和 pip 无关
真正容易被忽略的是:PyCharm 底部 Terminal 里运行的 pip 命令,走的是系统或虚拟环境的 pip 配置,和图形界面里的 Manage Repositories 完全独立。两个地方都得配,才算真正闭环。










