Microsoft C++ Build Tools 安装指南

背景

在 Windows 下安装某些 Python 包（如 ctc-segmentation 等）时，若出现报错：

error: Microsoft Visual C++ 14.0 or greater is required

说明该包需要本机 C/C++ 编译环境（MSVC）来编译扩展模块。按本教程安装后即可解决。

下载安装工具

访问 Microsoft C++ 生成工具 - Visual Studio 下载安装包。

运行安装器 vs_BuildTools.exe，点击继续。

选择 C++ 桌面开发，注意右侧至少勾选以下组件（建议保持默认，缺少后再增加）：

• ✅ MSVC v14.x (x64/x86)
• ✅ Windows 10/11 SDK
• ✅ C++ CMake tools for Windows（建议）

注意：对 Python 编译扩展而言，最核心的是 MSVC + Windows SDK。CMake 在一些包里也会用到，建议一起安装。

如果不想默认安装到 C 盘，可以更改安装位置。

在'安装位置'页确认占用空间并开始安装。

安装完成后重启电脑或重新打开终端。

配置环境变量

1. 搜索并打开'查看高级系统设置'。

2. 点击'环境变量'。

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

4. 新建环境变量，添加 MSVC 的 bin 路径。例如：

D:\A-Study\C++Envs\MicrosoftVisualStudio\18\BuildTools\VC\Tools\MSVC\14.50.35717\bin\Hostx64\x64

5. 打开 CMD 终端输入 cl。如图所示显示版本号即为成功安装。