Windows 系统安装 Microsoft Visual C++ Build Tools 详解

为什么需要安装 Visual C++ Build Tools

在 Windows 环境下开发或运行涉及 C++ 扩展的程序时（比如某些 Python 包、Node.js 模块），往往缺少本地编译器支持。这时候就需要安装 Microsoft Visual C++ Build Tools。

下载安装步骤

获取安装包

访问微软官方下载页面，找到 Build Tools for Visual Studio 的安装程序（通常是 vs_BuildTools.exe）。

建议直接搜索 "Visual Studio Build Tools" 进入官网，避免第三方链接带来的风险。

安装配置

双击运行安装包，进入安装向导。这一步很关键，不要点'快速安装'，而是点击 '自定义'。

在工作负载列表中，勾选 '使用 C++ 的桌面开发' 或者明确勾选 'C++ 生成工具'。确保以下组件被选中：

1. MSVC v14x - VS 2019/2022 C++ x64/x86 构建工具（版本尽量选最新的）
2. Windows 10/11 SDK（对应你的操作系统版本）

注意：虽然你可以更改主安装路径到非 C 盘，但部分核心组件默认仍会占用 C 盘空间。如果 C 盘剩余不足 10GB，请提前清理或扩容。

点击右下角的 '安装' 按钮，等待进度条走完。期间可能需要重启电脑，按提示操作即可。

配置环境变量

安装完成后，为了让命令行工具生效，需要手动添加环境变量。

1. 右键点击 '此电脑'，选择 '属性'。

2. 进入 '高级系统设置' > '环境变量'。

3. 在 '系统变量' 中找到 Path，双击编辑。

4. 新增一条路径，格式类似： C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\<版本号>\bin\Hostx64\x64

   具体版本号取决于你安装的版本，可以在安装目录中查看。

修改完成后，务必重启终端或 CMD，否则新路径不会立即生效。

验证安装

打开一个新的命令提示符窗口，输入以下命令：

cl

如果输出了编译器版本信息（如 Microsoft (R) C/C++ Optimizing Compiler Version...），说明环境配置成功，可以开始进行后续的开发工作了。

---

常见问题排查：

• 如果 cl 命令无效，检查是否安装了正确的 SDK 版本。
• 如果是 Python 报错，尝试升级 pip 或使用预编译的 wheel 包。