PyCharm装包超时或失败主因是未更换国内镜像源;需在Settings中通过Manage Repositories添加清华或阿里源并删除默认源,或全局修改pip.ini/pip.conf配置trusted-host。

PyCharm里装包超时或失败,大概率是没换源
PyCharm默认用的是国外pypi.org源,国内直连基本卡死或报ReadTimeout、ConnectionError。这不是你网络差,是物理距离和路由限制导致的必然现象。换源不是“可选项”,而是刚装完就必须做的动作。
在PyCharm界面中直接配清华/阿里源(推荐新手)
这是最安全、最直观的方式,所有操作都在GUI里完成,不碰配置文件,也不依赖命令行:
- 按
Ctrl+Alt+S(Windows/Linux)或Cmd+,(Mac)打开 Settings - 左侧展开
Project: [你的项目名]→ 点击Python Interpreter - 右上角点
+号 → 弹出窗口底部点Manage Repositories… - 点
+添加新源,填入:https://pypi.tuna.tsinghua.edu.cn/simple(清华)
或https://mirrors.aliyun.com/pypi/simple/(阿里) - 选中原来的
https://pypi.org/simple,点-删除;确保新源被勾选 - 点
OK保存,再点右上角刷新按钮,就能看到包列表加载变快
全局生效:改pip.ini或pip.conf(适合多项目用户)
上面方法只对当前项目有效。如果你有多个项目,或者希望终端里pip install也走国内源,就得改 pip 的全局配置文件:
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- Windows:在
%APPDATA%\pip\pip.ini(路径不存在就手动创建目录和文件) - macOS/Linux:在
$HOME/.pip/pip.conf - 文件内容写成这样(以清华源为例):
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn
- 注意:
trusted-host必须加,否则某些带证书校验的环境会拒绝连接
别踩这些坑
换源后仍失败?常见原因不是地址错了,而是细节没对上:
- 镜像地址末尾带不带斜杠都行,但中间不能少
/simple——写成https://pypi.tuna.tsinghua.edu.cn会 404 - PyCharm 的
Manage Repositories列表里,必须取消勾选旧源,否则它会并行尝试,反而拖慢解析速度 - 如果用了 conda 环境,
conda config --add channels配的是 conda 源,和 pip 无关,别混用 - 部分企业内网会拦截 HTTPS 请求,可临时试试 HTTP 版(如
http://pypi.tuna.tsinghua.edu.cn/simple),但仅限测试,生产环境不建议
真正麻烦的不是换源本身,而是换完之后发现某些包还是装不上——那往往不是源的问题,而是依赖冲突或 Python 版本不兼容。源只是第一步,别让它成为你卡住的借口。

















