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

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.exe 或 g++.exe 的子进程调用。这不是误报，是它们把构建阶段的内存映射、动态链接行为当成了可疑操作。

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

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

pip cache purge 只清 http 和 selfcheck 子目录，而真正卡住的是 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 -V、echo $VIRTUAL_ENV（Linux/macOS）或 echo %VIRTUAL_ENV%（Windows）
• 如果 sys.executable 指向 C:\Python39\python.exe，但 $VIRTUAL_ENV 是 D:\venv，说明 pip 装错地方了
• 安全做法：一律用 python -m pip install xxx，确保绑定当前解释器