通过命令行使用 Microsoft C++ 工具集

使用包含在 Visual Studio 中的工具，可在命令行上生成 C 和 C++ 应用程序。 Microsoft C++ (MSVC) 编译器工具集也可以作为独立的包下载。 如果不打算使用 Visual Studio IDE，则不需要安装它。

注意

本文介绍了如何设置环境来使用各个编译器、链接器、文档管理程序和其他基本工具。 Visual Studio 中基于 MSBuild 的本机项目生成系统不使用本文中所述的环境。 若要详细了解如何在命令行中使用 MSBuild，请参阅命令行上的 MSBuild - C++。

下载并安装工具

如果已安装 Visual Studio 和 C++ 工作负载，则可以使用所有命令行工具。 有关如何安装 C++ 和 Visual Studio 的信息，请参阅在 Visual Studio 中安装 C++ 支持。 如果只需要命令行工具集，请下载 Visual Studio 生成工具。 运行下载的可执行文件时，它会更新并运行 Visual Studio 安装程序。 若要仅安装 C++ 开发所需的工具，请选择“使用 C++ 的桌面开发”工作负载。 可选择要包含在“安装详细信息”下的可选库和工具集。 要使用 Visual Studio 2015、2017 或 2019 工具集生成代码，请选择可选的 MSVC v140、v141 或 v142 生成工具。 如果对选择感到满意，请选择“安装”。

如何使用命令行工具

在 Visual Studio 安装程序中选择一个 C++ 工作负载时，它会安装 Visual Studio 平台工具集。 平台工具集具有用于特定 Visual Studio 版本的所有 C 和 C++ 工具。 这些工具包括 C/C++ 编译器、链接器、汇编程序和其他生成工具以及匹配的库和头文件。 可以在命令行中使用所有这些工具。 Visual Studio IDE 在内部也使用这些工具。 可使用单独的 x86 托管和 x64 托管的编译器和工具来生成 x86、x64、ARM 和 ARM64 目标代码。 用于特定主机和目标生成体系结构的每组工具都存储在其自己的目录中。

需要设置几个特定的环境变量，这些工具才能正常运行。 这些变量用于将工具添加到路径，并设置包含文件、库文件和 SDK 的位置。 为了便于设置这些环境变量，安装程序会在安装期间创建自定义的命令文件或批处理文件。 可运行其中一个命令文件，以设置特定的主机和目标生成体系结构、Windows SDK 版本和平台工具集。 为方便起见，安装程序还会在“开始”菜单中创建快捷方式。 快捷方式通过将这些命令文件用于主机和目标的特定组合来打开开发人员命令提示符窗口。 这些快捷方式确保所有必需的环境变量都已设置并可供使用。

所需的环境变量特定于安装和选择的生成体系结构。 它们也可能因产品更新或升级而更改。 这种可变性是我们建议你使用已安装的命令提示符快捷方式或命令文件，而不是自行设置环境变量的原因之一。

安装的工具集、命令文件和快捷方式取决于计算机处理器和安装期间选择的选项。 请始终安装用于生成 x86 和 x64 代码的 x86 托管的工具和兼容工具。 如果你有 64 位 Windows，则还将安装用于生成 x86 和 x64 代码的 x64 托管的工具和兼容工具。 如果选择了可选的 C++ 通用 Windows 平台工具，则还将安装用于生成 ARM 和 ARM64 代码的 x86 和 x64 工具。 其他工作负载可能会安装这些工具和其他工具。

命令行生成的路径和环境变量

MSVC 命令行工具使用 PATH、TMP、INCLUDE、LIB 和 LIBPATH 环境变量，还使用特定于已安装工具、平台和 SDK 的其他环境变量。 即使是简单 Visual Studio 安装，也可以设置二十或更多个环境变量。 正是考虑到这种复杂性，我们强烈建议使用开发人员命令提示符快捷方式或一个自定义命令文件。 建议不要自行在 Windows环境中设置这些变量。

若要查看通过开发人员命令提示符快捷方式设置的环境变量，可以使用 SET 命令。 打开一个普通命令提示符窗口，并捕获 SET 命令输出以用作基线。 打开开发人员命令提示符窗口，并捕获 SET 命令输出以用于比较。 使用差异工具（如 Visual Studio 中内置的工具）突出显示通过开发人员命令提示符设置的环境变量。 有关编译器和链接器环境变量的详细信息，请参阅 CL 环境变量。

开发人员命令提示符快捷方式

命令提示符快捷方式安装在 Windows“开始”菜单中特定于版本的 Visual Studio 文件夹中。 以下是基本命令提示符快捷方式列表以及它们支持的生成体系结构：

• 开发人员命令提示符 - 将环境设置为使用 32 位 x86 本机工具生成 32 位 x86 本机代码。
• x86 本机工具命令提示符 - 将环境设置为使用 32 位 x86 本机工具生成 32 位 x86 本机代码。
• x64 本机工具命令提示符 - 将环境设置为使用 64 位 x64 本机工具生成 64 位 x64 本机代码。
• x86_x64 兼容工具命令提示符 - 将环境设置为使用 64 位 x64 本机工具生成 32 位 x86 本机代码。
• x64_x86 兼容工具命令提示符 - 将环境设置为使用 64 位 x64 本机工具生成 32 位 x86 本机代码。

“开始”菜单文件夹和快捷方式名称因安装的 Visual Studio 版本而异。 如果设置了一个，它们还取决于该安装的“昵称”。 例如，假设你安装了 Visual Studio 2022，并为其提供了一个昵称“最新”。 开发人员命令提示快捷方式将命名为“VS 2022 开发人员命令提示(最新)”，位于名为“Visual Studio 2022”的文件夹中。

注意

多个命令行工具或工具选项可能需要管理员权限。 如果在使用它们时遇到权限问题，则建议使用“以管理员身份运行”选项打开开发人员命令提示窗口。 右键单击以打开命令提示窗口的快捷菜单，然后依次选择“更多”、“以管理员身份运行”。

打开开发人员命令提示符窗口

1. 在桌面上，打开 Windows 的“开始”菜单。 在 Windows 11 中，选择“所有应用”按钮，打开已安装应用的列表。 在 Windows 10 中，列表在左侧打开。 向下滚动列表，找到并打开你的 Visual Studio 版本的文件夹（不是应用），例如，Visual Studio 2022。

2. 在该文件夹中，为 Visual Studio 版本选择“开发人员命令提示符”。 此快捷方式启动开发人员命令提示符窗口，该窗口使用 32 位 x86 本机工具的默认生成体系结构来生成 32 位 x86 本机代码。 如果你喜欢非默认的生成体系结构，请选择本机或兼容工具命令提示符之一，以指定主机和目标体系结构。

打开“开发人员命令提示”的更快方法是在桌面搜索框中输入“开发人员命令提示”。 然后选择所需的结果。

注意

默认情况下，开发人员命令提示符中的当前工作目录是 Program Files 目录中 Visual Studio 安装的根目录。 这不是代码和项目的合适位置。 在创建项目之前，将当前工作目录更改为另一个位置。 IDE 会在用户目录中创建项目，通常在 %USERPROFILE%\source\repos 中。

开发人员命令文件位置

如果想要在现有命令提示窗口中设置生成环境，则可以使用安装程序创建的命令文件之一。 我们建议你在新的命令提示窗口中设置环境。 但不建议你稍后在同一命令窗口中切换环境。

命令文件的位置取决于所安装的 Visual Studio 的版本以及在安装过程中所做的选择。 对于 Visual Studio 2019，64 位系统上的典型安装位置位于 \Program Files\Microsoft Visual Studio\2022\<edition> 中。 “<edition>”可以是 Community、Professional、Enterprise、BuildTools 或提供的其他昵称。

主开发人员命令提示符命令文件 VsDevCmd.bat 位于 Common7\Tools 子目录中。 如果未指定任何参数，该命令文件会将环境设置为使用 x86 本机工具生成 32 位 x86 代码。

还可使用更多命令文件设置特定的生成体系结构。 可用的命令文件取决于已安装的 Visual Studio 工作负载和选项。 在 Visual Studio 2017 和 Visual Studio 2019 中，可以在 VC\Auxiliary\Build 子目录中找到它们。

这些命令文件设置默认参数并调用 VsDevCmd.bat 以设置指定的生成体系结构环境。 典型安装可能包括以下命令文件：

命令文件	主机和目标体系结构
vcvars32.bat	使用 32 位 x86 本机工具生成 32 位 x86 代码。
vcvars64.bat	使用 64 位 x64 本机工具生成 64 位 x64 代码。
vcvarsx86_amd64.bat	使用 32 位 x86 本机兼容工具生成 64 位 x64 代码。
vcvarsamd64_x86.bat	使用 64 位 x64 本机兼容工具生成 32 位 x86 代码。
vcvarsx86_arm.bat	使用 32 位 x86 本机兼容工具生成 ARM 代码。
vcvarsamd64_arm.bat	使用 64 位 x64 本机兼容工具生成 ARM 代码。
vcvarsx86_arm64.bat	使用 32 位 x86 本机兼容工具生成 ARM64 代码。
vcvarsamd64_arm64.bat	使用 64 位 x64 本机兼容工具生成 ARM64 代码。
vcvarsall.bat	使用参数指定主机和目标体系结构、Windows SDK 和平台选项。 有关支持的选项列表，请使用 /help 参数进行调用。

注意

vcvarsall.bat 文件和其他 Visual Studio 命令文件可能因计算机而异。 不要使用另一台计算机中的文件替换丢失或损坏的 vcvarsall.bat 文件。 重新运行 Visual Studio 安装程序以替换丢失的文件。

vcvarsall.bat 文件在不同的版本中也会有所不同。 如果安装了当前版本 Visual Studio 的计算机上也安装了 Visual Studio 的早期版本，则不要在同一命令提示符窗口中运行不同版本的 vcvarsall.bat 或其他 Visual Studio 命令文件。

在现有命令窗口中使用开发人员工具

在现有命令窗口中指定特定生成体系结构的最简单方法是使用 vcvarsall.bat 文件。 使用 vcvarsall.bat 设置环境变量以配置本机 32 位或 64 位编译的命令行。 参数可用于指定到 x86、x64、ARM 或 ARM64 处理器的交叉编译。 可以将 Microsoft Store、通用 Windows 平台或 Windows 桌面平台作为目标。 甚至可以指定要使用的 Windows SDK，并选择平台工具集版本。

在没有参数的情况下使用时，vcvarsall.bat 将配置环境变量，使其使用当前面向 32 位 Windows 桌面版的 x86 位本机编译器。 可以添加参数来配置环境以使用任何本机或跨编译器工具。 如果你指定的配置未安装或在计算机上不可用，则 vcvarsall.bat 显示错误消息。

vcvarsall 语法

architecture
此可选参数指定要使用的主机和目标体系结构。 如果未指定体系结构，则使用默认生成环境。 支持以下参数：

architecture	编译器	主机计算机体系结构	生成输出（目标）体系结构
x86	x86 32 位本机	x86、x64	x86
x86_amd64 或 x86_x64	x86 跨平台上的 x64	x86、x64	x64
x86_arm	x86 跨平台上的 ARM	x86、x64	ARM
x86_arm64	x86 跨平台上的 ARM64	x86、x64	ARM64
amd64 或 x64	x64 64 位本机编译器	X64	X64
amd64_x86 或 x64_x86	x64 跨平台上的 x86	x64	x86
amd64_arm 或 x64_arm	x64 跨平台上的 ARM	X64	ARM
amd64_arm64 或 x64_arm64	x64 跨平台上的 ARM64	x64	ARM64

platform_type
可选择使用此自变量指定 store 或 uwp 作为平台类型。 默认情况下，环境设置为生成桌面或控制台应用。

winsdk_version
（可选）指定要使用的 Windows SDK 的版本。 默认情况下，使用最新安装的 Windows SDK。 若要指定 Windows SDK 版本，可使用完整的 Windows SDK 编号，例如 10.0.10240.0，或指定 8.1 以使用 Windows 8.1 SDK。

vcversion
（可选）指定要使用的 Visual Studio 编译器工具集。 默认情况下，环境设置为使用当前的 Visual Studio 编译器工具集。

使用“-vcvars_ver=14.2x.yyyyy”指定 Visual Studio 2019 编译器工具集的特定版本。

使用“-vcvars_ver=14.29”指定 Visual Studio 2019 编译器工具集的最新版本。

使用“-vcvars ver=14.0”指定 Visual Studio 2015 编译器工具集。

spectre_mode
请保留此参数，以使用没有 Spectre 缓解措施的库。 使用 spectre 值以使用带有 Spectre 缓解措施的库。

在现有命令提示符窗口中设置生成环境

1. 在命令提示符处，使用 CD 命令更改为 Visual Studio 安装目录。 然后，再次使用 CD 更改为包含特定于配置的命令文件的子目录。 对于 Visual Studio 2019 和 Visual Studio 2017，使用 VC\Auxiliary\Build 子目录。 对于 Visual Studio 2015，请使用 VC 子目录。

2. 输入用于首选开发人员环境的命令。 例如，若要使用最新的 Windows SDK 和 Visual Studio 编译器工具集在 64 位平台上为 UWP 生成 ARM 代码，请使用以下命令行：

   vcvarsall.bat amd64_arm uwp

创建自己的命令提示符快捷方式

打开开发人员命令提示快捷方式的“属性”对话框，查看使用的命令目标。 例如，“VS 2019 的 x64 本机工具命令提示符”快捷方式的目标如以下所示：

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat"

特定于体系结构的批处理文件设置 architecture 参数并调用 vcvarsall.bat。 可以将相同的选项传递给这些批处理文件，就像传递给 vcvarsall.bat 一样，或者可以直接调用 vcvarsall.bat。 若要为自己的命令快捷方式指定参数，请用双引号将其添加到命令末尾。 例如，可以通过下面的快捷方式，在 64 位平台上使用最新的 Windows SDK 为 UWP 生成 ARM 代码。 若要使用早期的编译器工具集，请指定版本号。 在快捷方式中使用类似此命令目标的内容：

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.29

调整路径以反映 Visual Studio 安装目录。 vcvarsall.bat 文件包含有关特定版本号的其他信息。

命令行工具

若要在命令提示符处生成 C/C++ 项目，可使用 Visual Studio 提供的以下命令行工具：

CL
使用编译器 (cl.exe) 可编译源代码文件，并将其链接到应用、库和 DLL 中。

Link
使用链接器 (link.exe) 可将已编译的对象文件和库链接到应用和 DLL 中。

在命令行上生成时，F1 命令不可用于即时帮助。 相反，可使用搜索引擎来获取有关警告、错误和消息的信息。 也可以下载并使用脱机帮助文件。 若要在 Microsoft Learn 中使用搜索，请在任意文章顶部的搜索框中输入查询。

命令行项目管理工具

默认情况下，Visual Studio IDE 使用基于 MSBuild 的本机项目生成系统。 你可以直接调用 MSBuild 来生成项目，而无需使用 IDE。 还可以通过使用 devenv 命令使用 Visual Studio 来生成项目和解决方案。 Visual Studio 还支持基于 CMake 或 NMake 的生成系统。

MSBuild
使用 MSBuild (msbuild.exe) 和项目文件 (.vcxproj) 来配置生成并调用工具集，而无需加载 Visual Studio IDE。 这相当于在 Visual Studio IDE 中运行“生成”项目或“生成解决方案”命令。 当你在命令行进行生成时，MSBuild 比 IDE 更具优势。 你无需在所有的生成服务器和生成管道上安装完整的 IDE。 这可避免 IDE 的额外开销。 MSBuild 在容器化生成环境中运行，并支持二进制记录器。

DEVENV
将 DEVENV (devenv.exe) 与命令行开关（例如，/Build 或 /Clean）结合使用，可在不显示 Visual Studio IDE 的情况下执行某些生成命令。

CMake
CMake (cmake.exe) 是一种跨平台开源工具，用于定义在多个平台上运行的生成过程。 CMake 可以为它支持的平台（例如 MSBuild 和 Make）配置和控制本机生成工具。 有关 CMake 的详细信息，请参阅 CMake 文档。

NMAKE
使用 NMAKE (nmake.exe) 来通过使用传统的生成文件以生成 C++ 项目。

注意

从 Visual Studio 2019 版本 16.5 起，MSBuild 和 DEVENV 不使用命令行环境来控制所使用的工具集和库。

本节内容

这些文章介绍了如何在命令行上生成应用程序，并说明了如何自定义命令行生成环境。 一些文章演示了如何使用 64 位工具集，以及如何以 x86、x64、ARM 和 ARM64 平台作为目标。 它们还介绍了如何使用命令行生成工具 MSBuild 和 NMAKE。

演练：在命令行上编译本机 C++ 程序
提供演示如何在命令行上创建和编译 C++ 程序的示例。

演练：在命令行上编译 C 程序
介绍了如何编译采用 C 编程语言编写的程序。

演练：在命令行上编译 C++/CLI 程序
介绍了如何创建和编译使用 .NET Framework 的 C++/CLI 程序。

演练：在命令行上编译 C++/CX 程序
介绍了如何创建和编译使用 Windows 运行时的 C++/CX 程序。

NMAKE 参考
提供指向介绍了 Microsoft 程序维护实用工具 (NMAKE.EXE) 的文章的链接。

命令行上的 MSBuild - C++
提供指向探讨如何从命令行使用 msbuild.exe 的文章的链接。

相关章节

/MD、/MT、/LD（使用运行时库）
介绍了如何使用这些编译器选项来使用“Debug”或“Release”运行时库。

C/C++ 编译器选项
提供指向探讨 C 和 C++ 编译器选项和 CL.exe 的文章的链接。

MSVC 链接器选项
提供指向探论链接器选项和 LINK.exe 的文章的链接。

其他 MSVC 生成工具
提供指向 Visual Studio 中包括的 C/C++ 生成工具的链接。

另请参阅

项目和生成系统