现代 C++ 开发工作流（VSCode / Cursor）

✅ 推荐的现代 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 buildcd buildcmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON ..make -jln -s build/compile_commands.json . # 可选，VSCode 更好识别

---

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

放在项目根目录的 .clangd 文件中：

CompileFlags: Add: [-Wall, -std=c++17]Diagnostics: UnusedIncludes: Strict ClangTidy: 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 是否正确读取？

---