使用 CMake Quick Start 创建一个 CMake hello world 项目

在本文中，你将学习如何使用 VS Code 中的 CMake Tools 扩展从头开始创建一个 CMake hello world 项目。

如果你已经有一个现有的 CMake 项目，并且在根目录中已经有一个 CMakeLists.txt 文件，但没有 CMake 预设，你可以跳到 创建 CMakePresets.json 文件 来使用 CMake 预设配置你的项目。

否则，创建一个新项目文件夹。在终端窗口中，创建一个名为 HelloWorld 的空文件夹，导航到该文件夹，并输入以下命令在其中打开 VS Code

mkdir helloworld
cd helloworld
code .

code . 命令在当前工作文件夹中打开 VS Code，该文件夹将成为你的“工作区”。

创建一个 CMakeLists.txt 文件

CMake Tools 扩展可以为你创建基本 CMake 项目的文件。

1. 打开命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 并运行 CMake: Quick Start 命令

   

2. 输入项目名称，并选择 C++ 作为项目语言。

   这些信息将被写入 CMakeLists.txt 和一些初始源文件。

   注意： 如果你在此文件夹中有其他源文件，并且希望将它们作为目标添加到 CmakeLists.txt 中，现在会提供一个添加这些文件的选项。但对于本教程，我们将坚持只使用 hello world 文件。

3. 选择 CTest 作为附加选项以添加测试支持。你还可以选择 CPack 以获得 CPack 支持。

   

4. 接下来，选择 Executable 作为项目类型以创建一个基本的源文件 (main.cpp)，其中包含一个基本的 main() 函数。

   

   注意： 如果你想要创建一个基本的源文件和头文件，你将选择 Library。但对于本教程，Executable 就足够了。如果系统提示你配置 IntelliSense，请选择 Allow。

这将成功创建 CMakeLists.txt 文件，该文件告诉 CMake 工具如何构建你的项目。

创建一个 CMakePresets.json 文件

接下来，继续使用 CMake Quick Start 创建一个 CMakePresets.json 文件。

1. 选择 Add a New Preset 并选择 Create from Compilers。

   该扩展会自动扫描你计算机上的工具包并创建一个在你的系统上找到的编译器列表。

2. 选择你想要使用的编译器。

   例如，根据你安装的编译器，你可能会看到如下内容

   

3. 输入此新预设的名称。

   预设的名称将被写入 CMakePresets.json。

完成这些步骤后，你现在应该有一个完整的 hello world CMake 项目，其中包含以下文件：main.cpp、CMakeLists.txt 和 CMakePresets.json。