根本原因是PyCharm默认调用海外pypi.org/simple源,国内直连易超时或卡死;最有效解法是通过Settings→Python Interpreter→Manage Repositories添加并置顶国内镜像源(如清华或阿里云),同时删除默认源并点击刷新生效。

PyCharm 安装包下载慢,根本原因不是软件本身有问题,而是它默认调用的 pip 指向了海外的 https://pypi.org/simple —— 这个地址在国内直连时经常超时、重试失败或卡在 0%,哪怕只是几 MB 的包。
最直接有效的解法是**让 PyCharm 的包管理器走国内镜像源**,而不是每次手动敲命令。下面分场景说明怎么做、为什么这么选、以及容易翻车的地方。
PyCharm 界面里改仓库地址(推荐首选)
这是对单个项目或当前解释器生效的最快方式,不碰系统级配置,也避免污染全局 pip。
- 打开
File → Settings(macOS 是PyCharm → Preferences)→ 左侧选Project: xxx → Python Interpreter - 点右上角
+号进入安装界面 → 点左下角Manage Repositories - 删掉默认的
https://pypi.org/simple,新增一个国内源,例如:https://mirrors.aliyun.com/pypi/simple/或https://pypi.tuna.tsinghua.edu.cn/simple - 务必确认 URL 以
https开头;如果填了http,PyCharm 会直接忽略并提示The repository located at mirrors.aliyun.com is not a trusted or secure host - 添加后点
OK,再回到上一级窗口点右上角的刷新图标(不是关掉重开),否则新源不会生效
pip install 命令行临时指定镜像(适合验证或单次安装)
当你只想快速装一个包、或者想确认某个镜像是否真能拿到你要的版本,直接终端里跑命令更轻量。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- 在 PyCharm 底部
Terminal里执行:pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests - 如果遇到证书错误或连接拒绝,加
--trusted-host参数:pip install -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn requests - 注意:不同镜像源收录的包版本可能有差异。比如某些预编译
.whl文件,阿里云有而豆瓣没有,遇到Could not find a version就换一个源试试
永久修改 pip 配置(影响所有终端和 PyCharm)
如果你不只在 PyCharm 里用 pip,还常在系统终端、VS Code 或脚本中安装包,统一配一次更省事。
- Windows:在
%APPDATA%\pip\pip.ini里写入:
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn timeout = 6000
$HOME/.pip/pip.conf 里写相同内容pip config list 确认生效;PyCharm 重启后也会自动读取这个配置为什么有些包在 PyCharm 里还是装不上?
换了源也不行,常见不是网络问题,而是环境或权限细节被忽略。
- 检查解释器路径是否正确:Settings → Project Interpreter → 看右上角路径是不是你预期的虚拟环境(比如
venv或conda环境),别误用了系统 Python - PyCharm 自带的
venv初始化时没联网,会导致首次pip不可用;可以先在 Terminal 里激活该环境后手动运行python -m pip install --upgrade pip - 某些包(如
pywin32、torch)依赖特定平台的二进制文件,国内镜像可能只同步了源码包(sdist),需要本地编译——这时候反而比直接下.whl慢。此时建议去对应官网找预编译包手动安装
http vs https)、或没删掉旧源,都会导致配置静默失效。真正起效的那一刻,进度条会从“卡死”变成“秒装”,而不是慢慢变快。

















