使用 CMake 快速入門建立一個 CMake Hello World 專案

在本文中，您將學習如何使用 VS Code 中的 CMake Tools 擴充功能，從頭開始建立一個 CMake Hello World 專案。

如果您已有一個在根目錄中包含 CMakeLists.txt 檔案但沒有 CMake 預設值（Presets）的現有 CMake 專案，您可以直接跳至建立一個 CMakePresets.json 檔案，以使用 CMake 預設值來配置您的專案。

否則，請為新專案建立一個資料夾。從終端機視窗中，建立一個名為 HelloWorld 的空資料夾，進入該資料夾，並輸入下列指令以在該資料夾中開啟 VS Code：

mkdir helloworld
cd helloworld
code .

code . 指令會在目前工作資料夾中開啟 VS Code，該資料夾將成為您的「工作區」。

建立一個 CMakeLists.txt 檔案

CMake Tools 擴充功能可以為您建立基礎 CMake 專案所需的檔案。

開啟命令面板（⇧⌘P (Windows, Linux Ctrl+Shift+P)）並執行 CMake: Quick Start 指令。
輸入專案名稱，並選擇 C++ 作為專案語言。

此資訊將寫入至 CMakeLists.txt 以及幾個初始原始程式檔中。

注意：如果您在此資料夾中有其他想要新增為 CMakeLists.txt 目標（targets）的原始程式碼檔案，現在會出現新增它們的選項。但對於本教學課程，我們僅使用該 Hello World 檔案。
選擇 CTest 作為額外選項以新增測試支援。您也可以選擇 CPack 以獲得 CPack 支援。
接下來，選擇 Executable（可執行檔）作為專案類型，以建立一個包含基礎 main() 函式的基本原始程式檔 (main.cpp)。

注意：如果您想要建立基本的原始程式檔和標頭檔，則應選擇 Library（程式庫）。但對於本教學課程，Executable 即可。如果系統提示您為此資料夾配置 IntelliSense，請選擇 Allow（允許）。

這將成功建立 CMakeLists.txt 檔案，該檔案會告知 CMake 工具如何建置您的專案。

Project contents

接下來，繼續進行 CMake 快速入門以建立 CMakePresets.json 檔案。

選擇 Add a New Preset（新增預設值）以及 Create from Compilers（從編譯器建立）。

該擴充功能會自動掃描您電腦上的工具組（kits），並建立一份在您的系統上找到的編譯器清單。
選擇您想要使用的編譯器。

例如，根據您已安裝的編譯器，您可能會看到類似以下的畫面：
為這個新預設值輸入名稱。

該預設值的名稱將寫入至 CMakePresets.json。

完成這些步驟後，您現在應該擁有一個完整的 Hello World CMake 專案，其中包含以下檔案：main.cpp、CMakeLists.txt 和 CMakePresets.json。

Add a new preset

5/29/2024