必须用pip config set global.index-url命令全局配置清华或阿里云镜像源,而非仅依赖PyCharm界面设置,因UI配置仅限图形安装且不生效于Terminal、脚本及新项目。

PyCharm 默认走官方 PyPI 源(pypi.org),国内直连通常卡在 50–200KB/s,装个 torch 或 tensorflow 经常超时失败。真正有效的加速方案不是点几下 UI,而是让所有 pip 调用——无论是在 PyCharm 的包管理界面、Terminal 还是脚本里运行 pip install——都强制走清华或阿里云镜像。关键在于:全局配置文件 > IDE 界面配置 > 临时命令行参数。
为什么 PyCharm 的 “Manage Repositories” 配置经常失效
这个界面(在 Python Packages 面板齿轮图标里)只影响当前项目的解释器,且仅对通过 IDE 图形界面点击“+”安装包时生效。它不控制 Terminal 中的 pip install,也不影响你右键运行 Python 脚本时自动触发的依赖安装(比如 Poetry 或 PDM 的 hook)。更麻烦的是,新建项目、切换虚拟环境后,这套配置就丢了。
- 常见错误现象:
pip config list显示已配置清华源,但 PyCharm Terminal 里pip install requests仍连pypi.org,并报ReadTimeoutError - 根本原因:PyCharm 2023.2+ 默认为每个解释器启动独立的 pip 进程,若未在系统级配置,它会忽略用户目录下的
pip.conf或pip.ini - 解决方案:必须用
pip config set global.index-url命令写入配置,而非只靠 UI 添加
Windows/macOS 一劳永逸的全局配置方式
这条命令会生成/修改用户级配置文件(Windows 是 %APPDATA%\pip\pip.ini,macOS/Linux 是 $HOME/.pip/pip.conf),PyCharm 启动的任何 pip 进程都会读取它。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- 在 PyCharm 底部 Terminal 中执行(推荐清华源):
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple - 同时加信任主机(避免 SSL 错误):
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn - 如果提示
PermissionError,说明 pip 配置目录被占用,可手动创建:mkdir %APPDATA%\pip(Win)或mkdir -p $HOME/.pip(macOS/Linux) - 验证是否生效:
pip config list应输出global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'
PyCharm Terminal 仍走官方源?检查这三点
即使全局配置完成,PyCharm Terminal 有时仍绕过镜像,多因环境隔离导致。
- 确认 Terminal 使用的是项目解释器,而不是系统 Python:在 Terminal 左上角下拉菜单中选对解释器路径(如
venv/bin/python或./venv/Scripts/python.exe) - 检查是否启用了
pip --no-cache-dir或--find-links类参数,它们会覆盖index-url - 某些插件(如 Poetry、Conda)会自带 pip 配置逻辑,此时需额外设置:
poetry config repositories.my-mirror.url https://pypi.tuna.tsinghua.edu.cn/simple
最易被忽略的一点:PyCharm 的「Python Packages」面板和 Terminal 共享同一套 pip 配置,但如果你在 Settings → Project → Python Interpreter 页面右下角点“+”安装包,它可能缓存了旧的源列表。遇到这种情况,删掉 Manage Repositories 里所有非镜像条目,再重启 PyCharm —— 不是重载项目,是彻底关闭再打开 IDE 进程。










