使用CMake快速入门创建一个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: 快速开始 命令:

    创建CMake快速开始

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

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

    注意: 如果您在此文件夹中有其他想要作为目标添加到CmakeLists.txt的源代码文件,现在将提供添加这些文件的选项。但对于本教程,我们将仅使用hello world文件。

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

    附加选项

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

    选择项目类型

    注意: 如果你想创建一个基本的源文件和头文件,你应该选择。但在本教程中,可执行文件就足够了。如果系统提示你为文件夹配置IntelliSense,请选择允许

这成功创建了CMakeLists.txt文件,该文件告诉CMake工具如何构建您的项目。

项目内容

创建一个CMakePresets.json文件

接下来,继续使用CMake快速入门来创建一个CMakePresets.json文件。

  1. 选择添加新预设从编译器创建

    扩展程序会自动扫描您计算机上的工具包,并创建在您系统上找到的编译器列表。

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

    例如,根据你安装的编译器,你可能会看到类似这样的内容:

    添加新预设

  3. 为这个新预设输入一个名称。

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

完成这些步骤后,您现在应该拥有一个完整的 hello world CMake 项目,其中包含以下文件:main.cppCMakeLists.txtCMakePresets.json

添加一个新的预设