缺编译器，需安装Microsoft C++ Build Tools并勾选C++构建工具、Windows SDK和CMake工具，安装后必须重启终端验证cl命令；替代方案为conda install或手动安装匹配的.whl文件。
pip install 报 “Microsoft Visual C++ 14.0 or greater is required” 错误，不是网络问题、不是权限问题、也不是 pip 版本低——就是你缺编译器。Windows 默认不带 cl.exe，而很多库（如 numpy、pyarrow、lxml、py7zr）必须本地编译 C/C++ 扩展，没它就卡死。
怎么确认是缺 cl.exe 而不是其他问题？
看到错误里含以下任意一项，基本可锁定：
error: Microsoft Visual C++ 14.0 or greater is required-
Failed building wheel for xxx（后面紧跟着一堆 C 编译日志） -
cl.exe not found或'cl' is not recognized as an internal or external command
这时别急着升级 pip 或换镜像源——先验证编译器是否存在：
cl
如果提示“不是内部或外部命令”，说明环境变量根本没加载；如果输出版本信息（比如 Microsoft (R) C/C++ Optimizing Compiler Version 19.3x），那问题在别处。
只装 Build Tools，别碰完整版 Visual Studio
Visual Studio Community 体积超 10GB，还带 IDE 界面——你只是想装个 scipy，不是要写 C++ 项目。真正需要的是独立的 Build Tools（约 1.5–2GB），官网直达：https://www.php.cn/link/2f93b699c738691d0b53d82ed1e25817
安装时务必勾选：
-
C++ build tools（核心，含cl.exe、link.exe） -
Windows 10/11 SDK（缺这个会报winreg.h not found等头文件错误） - （推荐）
CMake tools for Visual Studio（torch、onnxruntime等新包依赖它）
安装完必须关掉所有终端（CMD / PowerShell / VS Code 内置终端），再新开——否则 PATH 不生效，cl.exe 依然找不到。
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
装完仍失败？检查这三件事
即使 cl.exe 能跑了，pip install 还可能绕过本地构建、去 PyPI 找预编译 .whl，结果因平台/Python 版本不匹配而失败。这时要主动干预：
- 先升级构建工具链：
python -m pip install --upgrade pip setuptools wheel（旧版setuptools对新版 MSVC 兼容性差） - 避免 pip 自作聪明跳过编译：临时加
--no-binary :all:测试是否真能编译（仅调试用，慢且易出错） - 若只想快速装上，优先换用
conda install（conda install -c conda-forge numpy），它默认走预编译二进制，不碰cl.exe
手动下 .whl 是备选方案，但要注意三重匹配：Python 版本（如 cp311）、架构（win_amd64）、Windows SDK 版本（隐含在 .whl 文件名中），错一个就 ImportError。
为什么有些机器装了也不行？
常见漏点：
- 用了 WSL 或 Git Bash：它们不继承 Windows 的
PATH，得用原生 PowerShell 或 CMD 验证cl.exe - Python 是 32 位，但装了 64 位 Build Tools：两者不兼容，必须匹配（现在几乎全是 64 位）
- 同时装了多个 VS 版本（2017/2019/2022），导致
distutils混淆工具集（v142/v143）——重装时勾选“清理旧组件”或直接用vs_BuildTools.exe --quiet --norestart --nocache --installPath D:\BuildTools静默指定路径
最常被忽略的其实是重启终端——不是重启电脑，是关掉所有已打开的命令行窗口，再开新的。这点不做到，前面全白干。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
