一招处理pip install卡顿困难 | Python编写避坑指南
作者：唐叔在学习
专栏：唐叔学python
关键词标签：#pip安装卡住#Python开发#pip升级#源码安装#FunASR#Python包管理
问题场景：pip install -e ./ 卡住不动
最近在配置一个开源项目——FunASR（语音识别工具库）时，唐叔照常执行源码安装命令：
pip3 install -e ./结果命令行界面卡在了这一步：
Obtaining file:///D:/opensource/FunASR
Preparing metadata (setup.py) ... canceled界面一动不动，等了几分钟也没反应，如图：
这时候如果你也像唐叔一样忍不住按下 Ctrl + C 中断，可能会看到这样的提示：
原来，pip自己提示要升级了！
解决方法：升级pip工具
既然pip自己都说了有新版本，那我们就顺手更新一下，执行提示中的命令：
python.exe -m pip install --upgrade pip或者如果你系统里同时有Python3和Python2，也可以用：
python3 -m pip install --upgrade pip更新过程一般很快。
再次安装，顺利通过！
更新完pip之后，再次执行安装命令：
pip3 install -e ./这次就不再卡顿了，顺利进入依赖下载和安装环节，问题解决！
为什么升级pip就能解决？
唐叔简单给大家捋一捋原因：
- 老版本pip可能存在兼容性或性能问题，尤其是在处理本地路径（
file:///）或复杂依赖关系时。 - 新版本pip通常修复了已知bug，提升了安装过程的稳定性和速度。
-e参数表示“可编辑模式”安装，会动态链接到源码目录，对pip的解析能力要求较高。
所以，当pip安装过程卡住时，第一个应该尝试的就是升级pip本身，这是一个低成本高回报的操作。
总结
pip install -e ./卡住不一定是你代码或环境的问题，很可能是pip工具版本过旧。- 遇到类似问题，先看提示，按提示升级pip往往能直接解决。
- 保持开发环境中常用工具（如pip、setuptools、wheel）处于较新版本，能避免很多玄学问题。
唐叔建议大家在遇到Python包安装问题时，不妨先试试升级pip，说不定就像本文这样，一招搞定，省时省力！
希望这篇小记能帮到你！如果有其他Python环境或安装问题，欢迎在评论区交流～唐叔会持续分享实战中的小技巧和避坑经验！
附：常用pip命令备忘
# 升级pip
python -m pip install --upgrade pip
# 安装本地项目（开发模式）
pip install -e .
# 查看已安装的包
pip list
# 检查过时的包
pip list --outdated往期Python文章推荐
浙公网安备 33010602011771号