Visual Studio 将“CMake”项添加到“项目”菜单，其中包含用于查看和编辑 CMake 脚本的命令 。

解决方案资源管理器会显示文件夹结构和文件。

Visual Studio 会运行 CMake，并为默认配置生成 CMake 缓存文件 ( CMakeCache.txt )。 “输出窗口”中显示 CMake 命令行以及 CMake 的其他输出。

在后台，Visual Studio 开始对源文件编制索引，以启用 IntelliSense、浏览信息和重构等等。 随着工作进行，Visual Studio 监视器在编辑器和磁盘中随之发生变化，以保持其索引与源同步。

从 Visual Studio 2022 版本 17.1 预览版 2 开始，如果顶级 CMakeLists.txt 存在于子文件夹中，而不是位于工作区根目录中，系统会提示是否要启用 CMake 集成。 有关详细信息，请参阅 CMake 部分激活 。

成功生成 CMake 缓存后，还可按目标以逻辑方式查看项目。 在“解决方案资源管理器”工具栏上选择“选择视图”按钮。 在“解决方案资源管理器 - 视图”的列表中，选择“CMake 目标视图”，然后按 Enter 打开目标视图：

选择“解决方案资源管理器”顶部的“显示所有文件”按钮，以查看 out/build/<config> 文件夹中 CMake 生成的所有输出。

如同在任意 CMake 项目中一样，使用每个项目文件夹中的 CMakeLists.txt 文件。 可以指定源文件、查找库、设置编译器和链接器选项，以及指定其他与生成系统相关的信息。 若要详细了解 Visual Studio 提供的 CMake 语言服务，请参阅 编辑 CMakeLists.txt 文件 。

Visual Studio 使用 CMake 配置文件来促使生成和构建 CMake 缓存。 有关详细信息，请参阅 配置 CMake 项目 和 生成 CMake 项目 。

若要在调试时将参数传递给可执行文件，可以使用另一个名为 launch.vs.json 的文件。 若要详细了解如何在 Visual Studio 中调试跨平台 CMake 项目，请参阅 调试 CMake 项目 。

Visual Studio 中的 CMake 项目支持大多数 Visual Studio 和 C++ 语言功能。 示例包括：

CMake 项目的“编辑并继续”功能

CMake 项目的 Incredibuild 集成

对 CMake 项目的 AddressSanitizer 支持

Clang/LLVM 支持

对于其他类型的“打开文件夹”项目，将使用另外一个 JSON 文件 CppProperties.json 。 此文件与 CMake 项目无关。

配置 CMake 项目

可通过 CMake 配置步骤获得项目生成系统。 这等效于从命令行调用 cmake.exe 。 若要详细了解 CMake 配置步骤，请参阅 CMake 文档 。

Visual Studio 使用 CMake 配置文件来促使生成和构建 CMake。 Visual Studio 2019 版本 16.10 或更高版本支持 CMakePresets.json ，它也是推荐的 CMake 配置文件。 CMakePresets.json 受到 CMake 直接支持，它可用于促使通过 Visual Studio、VS Code、持续集成管道和 Windows、Linux 与 Mac 上的命令行来生成和构建 CMake。 若要详细了解 CMakePresets.json ，请参阅 使用 CMake 预设进行配置和生成 。 CMakeSettings.json 适用于使用早期版本的 Visual Studio 的客户。 若要详细了解 CMakeSettings.json ，请参阅 自定义 CMake 生成设置 。

对 CMake 配置文件或 CMakeLists.txt 文件进行重大更改时，Visual Studio 会自动运行 CMake 配置步骤。 可以手动调用配置步骤：从工具栏中选择“项目”>“配置缓存”。 还可在“工具”>“选项”>“CMake”>“常规”中更改配置首选项。

如果配置步骤完成且未出错，可用的信息将促进使用 C++ IntelliSense 和语言服务。 这些信息也可在生成和调试操作中使用。

还可在 Visual Studio 中打开现有的 CMake 缓存。 有关详细信息，请参阅 打开现有缓存 。

自定义配置反馈和通知

默认情况下，除非出现错误，否则将禁止显示大多数配置消息。 若要查看所有消息，请选择“工具”>“选项”>“CMake”>“启用详细 CMake 诊断输出” 。

还可取消选择“显示 CMake 缓存通知”来禁用所有 CMake 缓存通知（金色栏）。

排查 CMake 缓存错误

如果需要有关 CMake 缓存状态的详细信息来诊断问题，请打开“项目”主菜单或“解决方案资源管理器”中的 CMakeLists.txt 上下文菜单，运行以下某个命令：

View CMakeCache.txt 在编辑器中从生成目录打开 CMakeCache.txt 文件。 如果清除缓存，会擦除在此处对 CMakeCache.txt 进行的任何编辑。 若要在清除缓存后保留更改，请参阅 自定义 CMake 设置 或 使用 CMake 预设进行配置和生成 。

“删除缓存并重新配置”功能会删除生成目录，然后从干净缓存重新配置。

“配置缓存”会强制运行生成步骤，即使 Visual Studio 认为环境是最新也是如此。

生成 CMake 项目

可通过 CMake 生成步骤获得一个已生成的项目二叉树。 这等效于从命令行调用 cmake --build 。 若要详细了解 CMake 生成步骤，请参阅 CMake 文档 。

要生成 CMake 项目，可选择执行以下操作：

在工具栏中，找到“启动项”下拉列表。 选择首选目录，然后按 F5 或选择工具栏上的“运行”按钮 。 项目首先自动生成，就像 Visual Studio 解决方案一样。

在解决方案资源管理器中，右键单击 CMake 目标视图处于活动状态的 CMake 目标，然后从上下文菜单选择“生成” 。

从主菜单中，选择“生成”>“全部生成”。 请确保已在工具栏的“启动项”下拉列表中选择了 CMake 目标。

生成结果按预期显示在“输出窗口”和“错误列表”中 。

编辑生成设置

Visual Studio 使用 CMake 配置文件来促使生成 CMake。 CMake 配置文件封装了本机生成工具开关和环境变量等生成选项。 如果 CMakePresets.json 是活动配置文件，请参阅 使用 CMake 预设进行配置和生成 。 如果 CMakeSettings.json 是活动配置文件，请参阅 自定义 CMake 生成设置 。 可在 Visual Studio 2019 版本 16.10 或更高版本使用 CMakePresets.json ，它是推荐的 CMake 配置文件。

调试 CMake 项目

所有可执行的 CMake 目标都显示在工具栏的“启动项”下拉列表中。 若要开始调试，请选择一个项并在工具栏中按“调试”>“开始调试”按钮。 在 CMake 项目中，“当前文档”选项只对 .cpp 文件有效。

如果在上次生成后进行了更改，则“调试”或“F5”命令会先生成项目 。 如果更改 CMake 配置文件（ CMakePresets.json 或 CMakeSettings.json ）或 CMakeLists.txt ，则会重新生成 CMake 缓存。

可通过设置 launch.vs.json 文件中的属性来自定义 CMake 调试会话。 若要自定义特定目标的调试设置，请在“启动项”下拉列表中选择目标，然后按“调试”>“调试并启动 <活动目标> 的设置”。 若要详细了解 CMake 调试会话，请参阅 配置 CMake 调试会话 。

CMake 项目的“仅我的代码”

使用 MSVC 编译器为 Windows 生成时，CMake 项目支持“仅我的代码”调试。 若要更改“仅我的代码”设置，请转到“工具”>“选项”>“调试”>“常规”。

CMake 项目的“编辑并继续”功能

使用 MSVC 编译器对 Windows 进行生成时，CMake 项目支持“编辑并继续”功能。 将以下代码添加到 CMakeLists.txt 文件中可启用“编辑并继续”功能。

if(MSVC)
  target_compile_options(<target> PUBLIC "/ZI")
  target_link_options(<target> PUBLIC "/INCREMENTAL")
endif()
附加到在 Linux 上运行的 CMake 项目
通过 Visual Studio，可调试在远程 Linux 系统或 WSL 上运行的进程，并使用 GDB 调试程序来调试它。 若要开始，请选择“调试”>“附加到进程…”，将“连接类型”设置为“SSH”，然后从连接管理器中的连接列表中选择你的连接目标    。 从可用进程列表中选择一个进程，然后按“附加”。 必须在 Linux 计算机上安装 GDB。 有关 SSH 连接的详细信息，请参阅连接管理器
 CMake 部分激活
在 Visual Studio 2022 版本 17.1 及更高版本中，如果根文件夹中不包含 CMakeLists.txt 文件，则不会自动启用 CMake 功能。 相反，对话框将提示你是否要为项目启用 CMake 功能。 如果拒绝，CMake 缓存生成不会启动，CMake 配置（CMakeSettings.json 或 CMakePresets.json 中）不会显示在配置下拉列表中。 如果接受，会看到工作区级别的配置文件 CMakeWorkspaceSettings.json（存储在 .vs 目录中），用于指定要为其启用 CMake 的文件夹。 （这些文件夹包含根 CMakeLists.txt 文件）。
接受的属性包括：
可以随时通过“项目”>“CMake 工作区设置”菜单命令访问 CMakeWorkspaceSettings.json，即使当前禁用 CMake 功能也是如此。
打开现有缓存
打开现有 CMake 缓存文件 (CMakeCache.txt) 时，Visual Studio 不会尝试为你管理缓存和生成树。 自定义或首选工具会完全控制 CMake 配置项目的方式。
可以将现有 CMake 缓存添加到打开的项目中。 执行该操作的方式与添加新配置相同。 有关详细信息，请参阅关于在 Visual Studio 中打开现有缓存的博客文章。
默认的现有缓存体验依赖于 cmake-server，后者已从版本 3.20 中的 CMake 中删除。 若要继续使用 Visual Studio 2019 版本 16.10 及更高版本中的现有缓存功能，请执行以下步骤之一：
手动安装 CMake 版本 3.19 或更低版本。 然后，在现有缓存配置中设置 cmakeExecutable 属性，以使用该版本的 CMake。
在现有缓存配置中，设置 cacheGenerationCommand 属性，以便让 Visual Studio 请求必要的基于 CMake 文件的 API 文件。 有关该设置的详细信息，请参阅 CMakeSettings.json 引用。
在生成缓存时，使用查询文件请求基于 CMake 文件的 API 文件，然后才在 Visual Studio 中将其打开。 如需查询文件说明，请参阅下一节：高级 CMake 缓存故障排除。
 高级 CMake 缓存故障排除
Visual Studio 使用 CMake 基于文件的 API（在版本 3.14 及更高版本中）在编辑器中填充特定于项目结构的信息。 有关详细信息，请参阅有关多根目录工作区和基于文件的 API 的 C++ 团队博客文章。
在生成 CMake 缓存之前，自定义或首选工具可能需要在生成输出文件夹（该文件夹包含 CMakeCache.txt）中创建一个名为 .cmake/api/v1/query/client-MicrosoftVS/query.json 的查询文件。 查询文件应包含以下内容：
{"requests":[{"kind":"cache","version":2},{"kind":"cmakeFiles","version":1},{"kind":"codemodel","version":2}]}
当自定义或首选工具生成缓存时，CMake 将文件置于 .cmake/api/v1/response 下，Visual Studio 使用它在编辑器中填充特定于项目结构的信息。
编辑 CMakeLists.txt 文件
若要编辑 CMakeLists.txt 文件，请右键单击“解决方案资源管理器”中的文件，并选择“打开”。 如果对文件进行更改，会显示一个黄色的状态栏，通知用户 IntelliSense 将更新。 可以选择取消该更新操作。 有关 CMakeLists.txt 的信息，请参阅 CMake 文档。
保存文件后，配置步骤立即自动再次运行，并在“输出”窗口中显示信息。 错误和警告显示在“错误列表”或“输出”窗口中 。 双击“错误列表”中的错误可导航到 CMakeLists.txt 中出现问题的行。
CMake 的语言服务
可在 Visual Studio 2019 版本 16.5 或更高版本中使用 CMake 的语言服务。 它通过 CMake 脚本文件中的 CMake 变量、函数和目标支持“转到定义”、“速览定义”和“查找所有引用”等代码导航功能。 有关详细信息，请参阅 CMake 脚本的代码导航。
CMake 项目操作
在 Visual Studio 2019 版本 16.5 或更高版本中使用 CMake 项目操作。 通过项目操作，无需手动编辑 CMake 脚本即可添加、删除和重命名 CMake 项目中的源文件和目标。 在解决方案资源管理器中添加或删除文件时，Visual Studio 会自动编辑 CMake 项目。 可以在多个位置添加或删除对 CMake 脚本的引用。 如果是这样，Visual Studio 会询问你想要在何处进行更改，并显示建议的更改预览。 有关分步说明，请参阅添加、删除和重命名 CMake 项目中的文件和目标。
CMake 项目的 IntelliSense
默认情况下，Visual Studio 会使用与活动 CMake 配置指定的编译器和目标体系结构匹配的 IntelliSense 模式。
如果 CMakePresets.json 是活动的 CMake 配置文件，则可在 Visual Studio 设置供应商映射中使用 intelliSenseMode 和 intelliSenseOptions 指定 IntelliSense 选项。 有关详细信息，请查看 Visual Studio 设置供应商映射参考。
如果 CMakeSettings.json 是活动的 CMake 配置文件，则可以使用 CMakeSettings.json 中的 intelliSenseMode 指定 IntelliSense 选项。 有关详细信息，请参阅 CMakeSettings.json 参考。
使用 CMake 工具链文件配置 IntelliSense
在 Visual Studio 2019 版本 16.9 及更高版本中，使用 CMake 工具链文件时，Visual Studio 会根据 CMake 变量在 CMake 项目中自动配置 IntelliSense。 有关详细信息，请参阅使用 CMake 工具链文件配置 IntelliSense。
Vcpkg 集成
在 Visual Studio 中打开的 CMake 项目与跨平台 C/C++ 依赖项管理器 vcpkg 进行集成。 在将 vcpkg 和 Visual Studio 配合使用之前，必须运行 vcpkg integrate install。 如需了解 vcpkg 的相关说明的详细信息，请参阅 vcpkg 文档。
如果 CMakeSettings.json 是活动的配置文件，Visual Studio 会自动将 vcpkg 工具链文件 (vcpkg.cmake) 传递至 CMake。 在 CMake 设置配置中指定任何其他工具链时，此行为会自动禁用。
如果 CMakePresets.json 是活动的配置文件，则需要在 CMakePresets.json 中将路径设置为 vcpkg.cmake。 建议使用环境变量 VCPKG_ROOT 而不是绝对路径来保持文件可共享。 有关详细信息，请参阅启用 vcpkg 与 CMake 预设的集成。               可在 Visual Studio 2019 版本 16.10 或更高版本使用 CMakePresets.json，它是推荐的 CMake 配置文件。
从命令行运行 CMake
如果 CMakePresets.json 是活动的 CMake 配置文件，可在 Visual Studio 之外轻松重现本地生成。 有关详细信息，请参阅通过命令行或 CI 管道运行 CMake。               Visual Studio 2019 版本 16.10 或更高版本中支持 CMakePresets.json，它也是推荐的 CMake 配置文件。
如果 CMakeSettings.json 是活动的 CMake 配置文件，则需要手动将 CMakeSettings.json 文件中编码的参数传递给 CMake。 如果已从 Visual Studio 安装程序安装 CMake，可以通过执行以下步骤从命令行运行它：
运行相应的 vsdevcmd.bat 文件 (x86/x64)。 有关详细信息，请参阅在命令行上生成。
切换到输出文件夹。
运行 CMake 以生成或配置应用。
Visual Studio 2017 具有对 CMake 的丰富支持，包括跨平台 CMake 项目。 “Visual C++ Tools for CMake”组件使用“打开文件夹”功能，让 IDE 能够直接将 CMake 项目文件（例如 CMakeLists.txt）用于 IntelliSense 和浏览。 支持 Ninja 和 Visual Studio 生成器。 如果使用 Visual Studio 生成器，则它会生成临时项目文件，并将它传递给 MSBuild。 但是，从不会加载项目来用于 IntelliSense 或浏览。 还可以导入现有 CMake 缓存。
“Visual C++ Tools for CMake”作为“使用 C++ 的桌面开发”和“使用 C++ 的 Linux 开发”工作负载的一部分进行安装。
有关详细信息，请参阅在 Visual Studio 中安装 C++ Linux 工作负载。
IDE 集成
选择“文件”>“打开”>“文件夹”打开一个包含 CMakeLists.txt 文件的文件夹时，将发生以下情况：
Visual Studio 将“CMake”菜单项添加到主菜单，其中包含用于查看和编辑 CMake 脚本的命令。
解决方案资源管理器显示文件夹结构和文件。
Visual Studio 运行 CMake 并根据需要生成默认配置（即 x86 Debug）的 CMake 缓存。 “输出窗口”中显示 CMake 命令行以及 CMake 的其他输出。
在后台，Visual Studio 开始对源文件编制索引，以启用 IntelliSense、浏览信息和重构等等。 随着工作进行，Visual Studio 监视器在编辑器和磁盘中随之发生变化，以保持其索引与源同步。
可以打开包含任意数量 CMake 项目的文件夹。 Visual Studio 检测并配置工作区中的所有“根”CMakeLists.txt 文件。 CMake 操作（配置、生成、调试）、C++ IntelliSense 和浏览可用于工作区中的所有 CMake 项目。
还可按目标查看经过逻辑组织的项目。 在“解决方案资源管理器”工具栏中，从下拉列表中选择“目标视图” ：
Visual Studio 使用名为 CMakeSettings.json 的文件存储 CMake 的环境变量或命令行选项。 借助 CMakeSettings.json 还可定义和存储多个 CMake 生成配置。 可以在 IDE 中方便地切换它们。
否则，请使用 CMakeLists.txt 来指定源文件、查找库、设置编译器和链接器选项（就像在任何 CMake 项目中进行操作一样），以及指定其他与生成系统相关的信息。
如果需要在调试时将参数传递给可执行文件，可以使用另一个名为 launch.vs.json 的文件。 在某些情况中，Visual Studio 会自动生成这些文件。 可以手动编辑它们，甚至可以自己创建文件。
对于其他类型的“打开文件夹”项目，将使用另外两个 JSON 文件：CppProperties.json 和 tasks.vs.json。 这些都与 CMake 项目无关。
导入现有缓存
导入现有 CMakeCache.txt 文件时，Visual Studio 自动提取自定义的变量，并基于这些变量创建一个预填充的 CMakeSettings.json 文件。 不会以任何方式修改原始缓存。 仍可从命令行或者借助用于生成原始缓存的任何工具或 IDE 使用该原始缓存。 新的 CMakeSettings.json 文件与项目的根 CMakeLists.txt 放在一起。 Visual Studio 基于设置文件生成新的缓存。 可在“工具”>“选项”>“CMake”>“常规”对话框中替代自动缓存生成。
并非缓存中的所有内容都会被导入。  生成器和编译器的位置等属性替换为已知适合用于 IDE 的默认值。
导入现有缓存
从主菜单中选择“文件”>“打开”>“CMake”：
此命令会显示“从缓存导入 CMake”向导。
导航到要导入的 CMakeCache.txt 文件，然后选择“确定”。 “从缓存导入 CMake 项目”向导随即显示：
在向导完成时，可在“解决方案资源管理器”中看到新的 CMakeCache.txt 文件，位于项目中的根 CMakeLists.txt 文件旁边。
生成 CMake 项目
要生成 CMake 项目，可选择执行以下操作：
在“常规”工具栏中，找到“配置”下拉菜单。 默认情况下，它可能显示“Linux-Debug”或“x64-Debug”。 选择首选配置，然后按 F5 或选择工具栏上的“运行”（绿色三角形）按钮 。 项目首先自动生成，就像 Visual Studio 解决方案一样。
右键单击“解决方案资源管理器”中的 CMakeLists.txt，并从上下文菜单中选择“生成”。 如果在文件夹结构中有多个目标，可以选择生成所有目标或仅生成某个特定目标。
从主菜单中选择“生成”>“生成解决方案”（F7 或 Ctrl+Shift+B）。 请确保已在“常规”工具栏的“启动项”下拉列表中选择了 CMake 目标 。
可以在 CMakeSettings.json 文件中自定义生成配置、环境变量、命令行参数和其他设置。 由此可进行更改，而无需修改 CMakeLists.txt 文件。 有关详细信息，请参阅自定义 CMake 设置。
生成结果按预期显示在“输出窗口”和“错误列表”中 。
在包含多个生成目标的文件夹中，可以指定要生成的 CMake 目标：在“CMake”菜单或 CMakeLists.txt 上下文菜单上选择“生成”项，以指定目标。 如果在 CMake 项目中按 Ctrl+Shift+B，则会生成当前活动文档。
调试 CMake 项目
若要调试 CMake 项目，请选择首选配置并按 F5。 或按工具栏中的“运行”按钮。 如果“运行”按钮提示“选择启动项”，请选择向下箭头并选择要运行的目标。 （在 CMake 项目中，“当前文档”选项只对 .cpp 文件有效。）
如果在上次生成后进行了更改，则“运行”或“F5”命令会先生成项目 。
可通过设置 launch.vs.json 文件中的属性来自定义 CMake 调试会话。 有关更多信息，请参阅配置 CMake 调试会话。
编辑 CMakeLists.txt 文件
若要编辑 CMakeLists.txt 文件，请右键单击“解决方案资源管理器”中的文件，并选择“打开”。 如果对文件进行更改，会显示一个黄色的状态栏，通知用户 IntelliSense 将更新。 可以选择取消该更新操作。 有关 CMakeLists.txt 的信息，请参阅 CMake 文档。
保存文件后，配置步骤立即自动再次运行，并在“输出”窗口中显示信息。 错误和警告显示在“错误列表”或“输出”窗口中 。 双击“错误列表”中的错误可导航到 CMakeLists.txt 中出现问题的行。
CMake 配置步骤
如果对 CMakeSettings.json 或 CMakeLists.txt 文件进行了重大更改，Visual Studio 会自动重新运行 CMake 配置步骤。 如果配置步骤正确完成，则可在 C++ IntelliSense 和语言服务使用所收集的信息。 这些信息也可在生成和调试操作中使用。
多个 CMake 项目可以使用相同的 CMake 配置名称（例如，x86-Debug）。 在选择该配置时会配置并生成所有这些项目（在其自己的生成根文件夹中）。 可以调试参与该 CMake 配置的所有 CMake 项目中的目标。
可以将生成和调试会话限制为工作区中的项目子集。 在 CMakeSettings.json 文件中创建具有唯一名称的新配置。 然后，将该配置仅应用于这些项目。 如果选择了该配置，则 IntelliSense 以及生成和调试命令仅应用于这些指定项目。
排查 CMake 缓存错误
如果需要有关 CMake 缓存状态的详细信息来诊断问题，请打开“CMake”主菜单或“解决方案资源管理器”中的 CMakeLists.txt 上下文菜单，运行以下某个命令：
              “查看缓存”会从编辑器的生成根文件夹中打开 CMakeCache.txt 文件。 （如果清除缓存，则会清除此处对 CMakeCache.txt 所做的所有编辑。若要在清除缓存后保留更改，请参阅自定义 CMake 设置。）
打开缓存文件夹：打开生成根文件夹的资源管理器窗口。
清理缓存：删除生成根文件夹，使下一个 CMake 配置步骤从清理缓存开始。
生成缓存：即使 Visual Studio 认为环境是最新的，也强制运行生成步骤。
可在“工具”>“选项”>“CMake”>“常规”对话框中禁用自动缓存生成。
单个文件编译
若要在 CMake 项目中编译单个文件，可在“解决方案资源管理器”中右键单击该文件。 从弹出菜单中选择“编译”。 通过使用 CMake 主菜单，还可生成当前在编辑器中打开的文件：
从命令行运行 CMake
如果已从 Visual Studio 安装程序安装 CMake，可以通过执行以下步骤从命令行运行它：
运行相应的 vsdevcmd.bat 文件 (x86/x64)。 有关详细信息，请参阅在命令行上生成。
切换到输出文件夹。
运行 CMake 以生成或配置应用。
在 Visual Studio 2015 中，Visual Studio 用户可使用 CMake 生成器生成 MSBuild 项目文件，IDE 之后可将该项目文件用于 IntelliSense、浏览和编译。
教程：在 Visual Studio 中创建 C++ 跨平台项目

配置 Linux CMake 项目

连接到远程 Linux 计算机

自定义 CMake 生成设置

CMakeSettings.json 架构参考

配置 CMake 调试会话

部署、运行和调试 Linux 项目

CMake 预定义配置引用