參加你附近的 ,瞭解 VS Code 中的 AI 輔助開發。

透過 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: Quick Start 命令

    Create CMake quickstart

  2. 輸入專案名稱,並選擇 C++ 作為專案語言。

    此資訊將被寫入 CMakeLists.txt 和一些初始原始檔中。

    注意: 如果此資料夾中還有其他原始碼檔案,並且你希望將其作為目標新增到 CmakeLists.txt 中,那麼現在會顯示一個新增這些檔案的選項。但在本教程中,我們將只使用 hello world 檔案。

  3. 選擇 CTest 作為附加選項以新增測試支援。你也可以選擇 CPack 以獲得 CPack 支援。

    Additional Options

  4. 接下來,選擇 Executable 作為專案型別,以建立一個包含基本 main() 函式的基本原始檔 (main.cpp)。

    Choose project type

    注意: 如果你想建立一個基本的原始檔和標頭檔案,你應該選擇 Library。但在本教程中,Executable 就可以了。如果系統提示你為該資料夾配置 IntelliSense,請選擇允許

這樣就成功建立了 CMakeLists.txt 檔案,該檔案告訴 CMake 工具如何構建你的專案。

Project contents

建立 CMakePresets.json 檔案

接下來,繼續使用 CMake 快速入門來建立 CMakePresets.json 檔案。

  1. 選擇 Add a New Preset (新增新預設),然後選擇 Create from Compilers (從編譯器建立)。

    該擴充套件會自動掃描你計算機上的工具集 (kits),並建立一個在你係統上找到的編譯器列表。

  2. 選擇你想要使用的編譯器。

    例如,根據你安裝的編譯器,你可能會看到類似這樣的內容

    Add a new preset

  3. 為這個新預設輸入一個名稱。

    預設的名稱將被寫入 CMakePresets.json

完成這些步驟後,你現在應該擁有一個完整的 hello world CMake 專案,其中包含以下檔案:main.cppCMakeLists.txtCMakePresets.json

Add a new preset