根本原因是pycharm调用的pip默认连接境外pypi源(https://pypi.org/simple/),国内直连易超时;需确认解释器路径匹配、为pycharm单独配置国内镜像源(如清华源)、区分并同步配置conda与pip双源。

PyCharm里pip install卡住或报ReadTimeoutError
根本原因不是PyCharm本身有问题,而是它调用的pip默认走国外源(https://pypi.org/simple/),在国内直连大概率超时。错误日志里反复出现ReadTimeoutError或ConnectionTimeout,基本可以锁定是网络源问题。
别急着重装或换解释器——先确认当前PyCharm用的是哪个pip:打开PyCharm终端,执行which pip(Linux/macOS)或where pip(Windows),看路径是否指向你Anaconda环境里的pip。如果指向系统Python或旧版本,说明解释器没配对,后面所有安装都会错位。
- 确保PyCharm项目解释器已正确设置为Anaconda某个环境下的
python.exe(如~/anaconda3/envs/myenv/python.exe) - 在PyCharm终端中运行
python -m pip --version,确认显示的pip版本和Python路径匹配 - 若不匹配,回到
Settings → Project → Python Interpreter,点击齿轮→Add → Conda Environment → Existing environment,重新指定该环境下的python路径
给PyCharm用的pip换国内镜像源(非全局)
全局改pip源会影响命令行,但PyCharm有时会忽略全局配置。最稳的方式是在PyCharm内部为当前解释器单独配源——这样既不影响系统,又100%生效。
操作路径:Settings → Project → Python Interpreter,右上角点+号添加包,在弹出窗口左下角点Manage Repositories。这里能直接增删pip源,PyCharm会优先用列表顶部的源。
- 删除默认的
https://pypi.org/simple/ - 添加清华源:
https://pypi.tuna.tsinghua.edu.cn/simple/ - 或豆瓣源:
https://pypi.douban.com/simple/ - 顺序很重要:把国内源拖到最上面,PyCharm才优先用它
conda install和pip install混用导致的超时误判
很多人在PyCharm里点“Install package”后失败,就以为是pip超时,其实可能是PyCharm默认调用了conda install而非pip install——而conda源没配镜像,也会卡住或报错,但错误信息更隐蔽(比如只显示“Solving environment”然后不动)。
完整流程:Reddit 痛点扫描 → 聚类 → 构建 pip 可安装的 CLI 工具 → 推送到 GitHub。使用此模式已交付 5 款工具,经验证 343 条痛点。
检查方法:在PyCharm终端里手动执行conda install requests,如果卡在“Solving environment”,说明conda源也需要加速。
- 给conda配清华镜像:
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ - 再执行:
conda config --set show_channel_urls yes - 验证:
conda info --channels应看到清华域名 - 注意:conda镜像和pip镜像是两套系统,必须分别配置
PyCharm终端里pip升级失败或版本冲突
常见现象:点安装时报WARNING: pip is not up-to-date,接着ReadTimeoutError,升级命令python -m pip install --upgrade pip也超时——这是典型的“死循环”:旧pip连不上源,没法升级;不升级,新包又装不了。
破局关键是绕过默认源升级:
- 在PyCharm终端中运行:
python -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple/ - 升级成功后,再试安装包:
pip install jieba -i https://pypi.tuna.tsinghua.edu.cn/simple/ - 如果仍失败,检查是否被代理或防火墙拦截——临时关掉代理软件再试
- 避免用
pip install --upgrade pip这种不带-i参数的命令,它会再次走默认源
真正容易被忽略的点是:PyCharm的每个项目解释器都独立维护pip源配置,改了A项目的源,B项目不会自动同步;conda镜像则全局生效,但只影响conda install。两个源必须都配,且不能只配一个。










