Microsoft Visual C++ Build Tools 安装指南
在 Windows 环境下编译运行依赖 C++ 的程序或库时,往往需要安装 Microsoft Visual C++ Build Tools。无论是 Python 扩展包还是 Node.js 模块,遇到编译错误时,这通常是首要排查项。
下载安装程序
访问 Visual Studio Build Tools 官方下载页面。找到'下载'按钮,获取 vs_BuildTools.exe 安装程序。

双击运行下载好的文件,点击'继续'开始安装流程。

等待下载组件完成。

选择工作负载
进入安装选项界面,务必勾选以下两项核心组件:
- MSVC v142 - VS 2019 C++ x64/x86 构建工具(或更新的版本)
- Windows 10 SDK(根据实际系统版本选择对应 SDK)

虽然可以按需选择其他组件,但上述两项是编译 C++ 代码的基础。建议检查右下角预估安装大小,部分组件默认安装在 C 盘,请确保系统盘空间充足。
修改安装路径后,点击'安装'并等待完成。


配置环境变量
安装完成后,需将编译器路径加入系统环境变量,以便全局调用。
- 右键点击'此电脑',选择'属性'。
- 进入'高级系统设置',点击'环境变量'。
- 在'系统变量'中找到
Path,双击编辑。 - 添加类似以下路径(具体版本号以实际安装为准):
C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\<版本号>\bin\Hostx64\x64

配置完成后,请重启当前的命令提示符或终端窗口,新环境变量才能生效。
最后,在命令行中输入 cl 命令。若能显示版本信息,说明配置成功。


