非常游戏网
如何解决Python安装程序卡在预编译编译环节_关闭杀毒软件或清理缓存文件

如何解决Python安装程序卡在预编译编译环节_关闭杀毒软件或清理缓存文件

2026-05-29日常编程71608

pip卡在“Building wheel”或“Resolving packages…”主因是本地依赖解析或C++源码编译,非网络问题;关对进程、手动清缓存目录(如%LOCALAPPDATA%\pip\Cache或~/.cache/pip/Cache)、禁用杀软实时防护可解决多数情况。

Python安装程序卡在“Building wheel”或“Resolving packages…”不是网络慢,而是 pip 在本地暴力解析依赖或硬编译 C++ 源码——关杀软、清缓存能解决大部分问题,但得关对进程、删对目录。

为什么关杀毒软件有时真有用

Windows 上某些杀软(如 McAfee、360、腾讯电脑管家)会实时扫描 pip 解压的临时文件、.whl 内的 .so/.pyd 文件,甚至拦截 cl.exeg++.exe 的子进程调用。这不是误报,是它们把构建阶段的内存映射、动态链接行为当成了可疑操作。

  • 典型现象:安装 dlibopencv-python 时,CPU 占用突然掉到 0%,任务管理器里 python.exe 状态变成“挂起”或“暂停”
  • 验证方法:临时禁用实时防护(不是退出杀软),再重试 pip install --verbose dlib,看日志是否恢复输出
  • 注意:仅需关实时防护,不需卸载;macOS/Linux 几乎不受影响,不用折腾

清理 pip 缓存必须手动删目录,pip cache purge 不够用

pip cache purge 只清 httpselfcheck 子目录,而真正卡住的是 Cache/(旧版)或 http/ 下残留的半成品 .whl、损坏的 METADATA、以及与当前 Python ABI 不兼容的构建中间产物。

Python 3.14.3

微软官方的 Python 扩展,是 VS Code 安装量最高的扩展(209M+)。集成 IntelliSense(通过 Pylance)、调试(通过 Python Debugger)、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。

  • Windows 要删:%LOCALAPPDATA%\pip\Cache(不是 %APPDATA%
  • macOS/Linux 要删:~/.cache/pip/Cache~/.cache/pip/http(注意大小写,Cache 是大写)
  • 顺手检查:~/.local/share/virtualenv/--user 安装残留)和虚拟环境下的 build/dist/ 目录
  • 删完别急着重装,先运行 pip cache info 确认路径已空

卡在 Building wheel for xxx?大概率是正在编译,不是卡死

比如 opencv-python 卡在 48%,dlib 卡在 “running build_ext”,只要 CPU 满载、内存稳定增长,就是正常编译。PEP 517 构建流程本身不带进度条,终端静默是常态。

  • 判断依据:pip install --verbose opencv-python 2>&1 | grep -i "building\|compiling"(Linux/macOS);Windows 用 pip install --verbose ... > log.txt 2>&1 后搜 Building
  • 常见耗时模块:modules/dnn/(AVX2/AVX-512 优化)、modules/gpu/(CUDA 支持)、dlib/cuda/
  • 真卡死信号:CPU ps aux | grep python 显示进程状态为 T(stopped)或长时间无日志输出

最常被忽略的坑:虚拟环境污染 + 错误的 Python 解释器路径

你在终端里敲 pip install dlib,看似在 venv 里,但实际调用的可能是系统 Python 的 pip——尤其当你用 VS Code、PyCharm 或 Conda 激活环境后又开了新终端,或没确认 which python / where python 输出。

  • 必查三件事:python -c "import sys; print(sys.executable)"pip -Vecho $VIRTUAL_ENV(Linux/macOS)或 echo %VIRTUAL_ENV%(Windows)
  • 如果 sys.executable 指向 C:\Python39\python.exe,但 $VIRTUAL_ENVD:\venv,说明 pip 装错地方了
  • 安全做法:一律用 python -m pip install xxx,确保绑定当前解释器