🚀 在 VS Code 中

使用 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: 快速入门 命令

    Create CMake quickstart

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

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

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

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

    Additional Options

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

    Choose project type

    注意: 如果你想创建基本源文件和头文件,则应选择 。但是对于本教程,可执行文件 即可。如果系统提示你为文件夹配置 IntelliSense,请选择 允许

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

Project contents

创建 CMakePresets.json 文件

接下来,继续 CMake 快速入门以创建 CMakePresets.json 文件。

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

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

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

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

    Add a new preset

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

    预设的名称将写入 CMakePresets.json

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

Add a new preset