缺 Microsoft C++ 编译器导致 pip 编译失败，需安装 Microsoft C++ Build Tools 并勾选 CMake 工具和 Windows SDK，重启终端后验证 cl 命令；替代方案包括 conda install、手动安装 .whl 文件或换用 Miniconda/Anaconda。
Windows 上 pip install 报 “Microsoft Visual C++ 14.0 or greater is required” 就是缺编译器，不是缺 Python，也不是网络问题 —— 装对工具、重启终端、选对安装路径，三步就能过。
为什么 pip 会卡在编译这一步
很多包（比如 lxml、cryptography、pyarrow）内部含 .c 或 .cpp 文件，pip 默认尝试本地编译生成扩展模块。Windows 没预装 C++ 编译器，cl.exe 找不到，就直接报错退出。
这不是 pip 版本低、不是镜像源慢、也不是权限不够 —— 是整个构建链路缺失。你看到的错误末尾那句 “Get it with ‘Microsoft C++ Build Tools’” 就是官方提示，别忽略它。
- 完整版 Visual Studio 太重，没必要：只用到其中几个组件，装它等于下载 10GB+ 冗余内容
- Python 自带的
distutils或setuptools不提供编译器，只负责调用 - conda 安装能绕过这步，是因为它用的是预编译二进制（
.whl），但不是所有包都支持
只装 Microsoft C++ Build Tools，不装 VS
去官网下载独立版：Microsoft C++ Build Tools（免费，2026 年仍有效）。
安装时关键勾选两项：
-
CMake tools for Visual Studio（很多新包依赖 CMake 构建） -
Windows 10/11 SDK（缺这个会导致winreg.h等头文件找不到）
装完必须关掉所有终端（CMD / PowerShell / VS Code 终端），再重新打开 —— 否则环境变量没加载，cl.exe 依然不可见。验证方式很简单：
cl
如果输出 Microsoft 版本信息（比如 “Microsoft (R) C/C++ Optimizing Compiler Version 19.3x”），说明成功；如果报 “不是内部或外部命令”，就是没重启终端或路径没生效。
Python 3.14.3
微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
比装编译器更快的三种替代方案
能不编译就不编译，尤其在开发机或 CI 环境里，省时间还少出错。
- 优先用
conda install：比如conda install -c conda-forge lxml，conda-forge 更新快、二进制覆盖全，numpy、scipy、pillow这类基本无压力 - 手动下
.whl：访问 Gohlke 的非官方 wheel 库，搜包名 → 找匹配你 Python 版本（如cp311）、系统（win_amd64）、位数（64 位）的文件 →pip install xxx‑1.2.3‑cp311‑cp311‑win_amd64.whl - 换 Python 发行版：Miniconda 或 Anaconda 自带完整构建环境和大量预编译包，开箱即用，适合科学计算场景
注意：.whl 是社区维护，生产环境上线前务必确认其 ABI 兼容性；conda 和 pip 混用容易导致底层库（如 zlib、OpenMP）版本冲突，尤其在多环境共存时。
PyCharm 里安装失败？先确认解释器绑定的是哪个环境
PyCharm 的 Terminal 默认激活项目虚拟环境，但 Settings → Project Interpreter 可能指向系统 Python 或另一个 venv。执行 pip -V 看路径，和 which python（或 where python）对比是否一致。
常见陷阱：
- 你在命令行用 conda 激活了环境并装了包，但 PyCharm 解释器设成了系统 Python → import 必然报
ModuleNotFoundError - PyCharm 设置里点了 Install Package，但背后调用的是它内置的 pip，而该 pip 没连上 Build Tools → 依然报 C++ 14.0 错误
- 用了国内镜像源但没加
--trusted-host，SSL 验证失败后静默中断，看起来像编译失败
最稳的做法：在 PyCharm Terminal 里先跑 cl 验证编译器可用，再跑 pip install；如果还是失败，立刻切到 conda install 或 .whl 方式 —— 编译不是目的，能用才是关键。
