? 推薦的現代 C++ 開發工作流（含 VSCode / Cursor 插件配置）

---

🧰 一、環境要求

• C++ 編譯器（如 g++ 或 clang++）
• CMake（建議 ≥ 3.16）
• clangd（建議 ≥ 14，最好用系統包管理器安裝）
• VSCode 或 Cursor 編輯器

---

🪛 二、VSCode 插件安裝（適用于 VSCode 和 Cursor）

打開 VSCode 插件市場，安裝以下插件：

插件名稱	說明
? clangd	由 LLVM 官方維護的語言服務器，提供智能跳轉、補全等
? CMake Tools	用于管理構建配置、運行 cmake 構建
? CMake	提供 CMakeLists.txt 的語法高亮和智能感知
? CodeLLDB（可選）	高級調試功能（用于斷點、變量查看）
? Better C++ Syntax（可選）	顏色高亮更強

📝 Cursor 編輯器內置了對 clangd 的支持，只要項目中有 compile_commands.json，通常無需額外配置插件，但可通過設置檢查是否啟用 clangd。

---

?? 三、clangd 安裝與配置

1. 安裝 clangd（按平臺）

• macOS（推薦用 Homebrew）：

brew install llvm

• Ubuntu：

sudo apt install clangd-14

• Windows：

使用 LLVM 官方安裝包 安裝 clangd，并加入 PATH。

2. VSCode 設置 clangd 路徑（可選）

打開 VSCode 設置（Ctrl+Shift+P → Preferences: Open Settings (JSON)），添加：

"clangd.path": "/usr/bin/clangd"  // 或 /opt/homebrew/opt/llvm/bin/clangd

---

🧱 四、CMake 項目初始化與構建

項目結構建議：

my_project/
├── CMakeLists.txt
├── src/
│   └── main.cpp
├── include/
│   └── mylib.hpp
├── build/                  # 構建輸出目錄
└── .clangd                # clangd 配置（可選）

執行構建流程：

mkdir -p build
cd build
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON ..
make -j
ln -s build/compile_commands.json .  # 可選，VSCode 更好識別

---

📦 五、.clangd 示例配置（可選）

放在項目根目錄的 .clangd 文件中：

CompileFlags:Add: [-Wall, -std=c++17]
Diagnostics:UnusedIncludes: StrictClangTidy:Add: [-checks=modernize-*]

---

🧭 六、VSCode 項目配置推薦（可選）

.vscode/settings.json 示例：

{"C_Cpp.default.configurationProvider": "ms-vscode.cmake-tools","C_Cpp.default.compileCommands": "${workspaceFolder}/build/compile_commands.json","clangd.arguments": ["--background-index","--clang-tidy"],"cmake.sourceDirectory": "${workspaceFolder}","cmake.buildDirectory": "${workspaceFolder}/build"
}

---

? 七、日常工作流簡版回顧

步驟	命令 / 操作
初始化構建	cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON ..
編譯項目	make -j 或用 CMake Tools 插件點擊構建
清理構建	make clean 或 rm -rf build/
打開項目	VSCode / Cursor 自動識別并啟用 clangd
寫代碼 / 跳轉 / 補全 / 調試	全流程無阻礙
新增源文件	寫完保存，clangd 會自動索引，無需額外操作

---

🧠 提示

• 第一次打開項目：clangd 會慢慢建立 .cache/clangd/index，稍等幾秒即可

• 如果 Cursor 識別不到類型，優先檢查：

  • compile_commands.json 是否存在？
  • clangd 是否正確讀取？

---