直接安装官方Microsoft C++ Build Tools（2022/2024版）即可解决pip编译报错，无需且应避免使用已废弃的npm包windows-build-tools；必须勾选MSVC v143/v144、Windows SDK和CMake工具，并正确配置Hostx64\x64路径至Path环境变量，安装后重启终端运行cl验证。
直接装 Microsoft C++ Build Tools 就行，别碰 visualcpp-build-tools 这个已废弃的 npm 包，它早就不维护了，装了也白装。
为什么 pip install 报错 “Microsoft Visual C++ 14.0 or greater is required”
这不是 Python 缺少某个 DLL，而是 pip 在尝试从源码编译扩展（比如 pycocotools、ctc-segmentation、pybullet）时，根本找不到 C++ 编译器。Windows 默认不带 cl.exe，必须显式安装官方构建工具链。
常见错误现象包括：
- 报错里明确出现
error: Microsoft Visual C++ 14.0 or greater is required - 终端卡在
Building wheel for xxx...后崩溃 - 日志末尾有
Failed to build xxx+subprocess.CalledProcessError
装哪个版本？选哪个组件？路径怎么配
优先下载最新版 Build Tools（2022 或 2024），官网地址是：https://www.php.cn/link/2f93b699c738691d0b53d82ed1e25817。旧版（如 2015/2017）已停止支持，且和新版 Python（3.11+）、CUDA（12.x）兼容性差。
立即学习“Python免费学习笔记（深入）”；
安装时必须勾选：
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
-
MSVC v143 - VS 2022 C++ x64/x86 build tools（或对应年份的 v144） -
Windows 10/11 SDK（选最新可用版本，比如10.0.22621.0） -
CMake tools for Visual Studio（非必需但强烈建议，很多包用setup.py+CMakeLists.txt混合构建）
安装完成后，Path 环境变量要加这一行（路径以你实际安装位置为准）：
C:\Program Files\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.39.33519\bin\Hostx64\x64
注意：Hostx64\x64 表示“在 64 位 cmd 中编译 64 位代码”，如果你用的是 32 位 Python（极少见），才需加 Hostx86\x86。装完后重启终端，运行 cl，看到 Microsoft 版本信息即成功。
为什么装完还是报错？常见踩坑点
不是装了就万事大吉。以下情况会导致 cl.exe 被忽略或失效：
- 没重启命令行或 IDE：环境变量变更不会自动同步到已打开的终端，
cmd、PowerShell、VS Code 的集成终端都得关掉重开 - Python 和 Build Tools 架构不匹配：64 位 Python 必须配
Hostx64\x64路径；混用会报LINK : fatal error LNK1100或静默失败 - 多个 VS/BuildTools 共存时路径冲突：检查
Path里是否同时存在2019和2022的 MSVC 路径，旧路径排在前面会优先被调用，导致_MSC_VER不匹配（尤其影响 CUDA 扩展） - 虚拟环境未激活就 pip install：确保在
venv或conda环境激活状态下执行安装，否则可能 fallback 到系统 Python 的 site-packages，而那里没权限写入编译产物
替代方案：windows-build-tools 已过时，别用
windows-build-tools 是一个 npm 包，2021 年后就停止更新，它默认拉取的是 VS 2017 Build Tools，现在连 Windows 11 22H2 都不完全兼容。执行 npm install --global windows-build-tools 可能卡在 Python 3.8 下载，或装完后 cl.exe 根本不在 Path 里。
如果你已经装过，建议彻底卸载：
- 控制面板 → 卸载程序 → 找到 “Microsoft Build Tools” 或 “Visual C++ Build Tools” → 卸载
- 手动删残留目录：
C:\Program Files (x86)\Microsoft Visual Studio\2017\、C:\Program Files\Microsoft Visual Studio\2017\ - 清空
Path里所有含2017的 MSVC 路径
再按前面说的步骤重装 2022/2024 版 Build Tools —— 这才是当前最稳定、最省事的路径。
