VSCode 工作区配置文件通用模板（CMake + Ninja + MinGW/GCC 编译器 的 C++ 或 Qt 项目）

下面是一个通用模板，适用于大多数使用 VSCode + CMake + Ninja + MinGW/GCC 编译器 的 C++ 或 Qt 项目。你可以将这个 .vscode 文件夹复制到你的项目根目录下，稍作路径调整即可使用。

---

📁 .vscode/ 目录结构（通用模板）

.vscode/
├── settings.json       # 工作区设置（CMake 配置）
├── tasks.json          # 构建任务配置（CMake Configure & Build）
└── launch.json         # 调试器配置（GDB）

---

✅ 1. settings.json

{"cmake.generator": "Ninja","cmake.configureOnOpen": true,"cmake.buildDirectory": "${workspaceFolder}/build","cmake.clearOutputBeforeBuild": true,"cmake.useCmakeListsTxt": true,"files.exclude": {"**/.git": true,"**/.DS_Store": true,"**/__pycache__": true},"editor.tabSize": 4,"editor.formatOnSave": true
}

⚙️ 说明：

• 使用 Ninja 作为生成器；
• 打开项目时自动配置 CMake；
• 构建输出目录为 build/；
• 排除一些不必要的文件显示在资源管理器中；
• 设置默认缩进为 4 空格，保存时格式化代码。

---

✅ 2. tasks.json

{"version": "2.0.0","tasks": [{"label": "CMake: Configure","type": "shell","command": "cmake","args": ["-B", "${workspaceFolder}/build", "-G", "Ninja"],"group": { "kind": "build", "isDefault": true },"problemMatcher": ["$cmake"]},{"label": "CMake: Build","type": "shell","command": "cmake","args": ["--build", "${workspaceFolder}/build"],"group": { "kind": "build", "isDefault": true },"problemMatcher": ["$cmake"]},{"label": "CMake: Clean","type": "shell","command": "rm -rf build/*"}]
}

⚙️ 说明：

• CMake: Configure：运行 cmake -B build -G Ninja 来配置构建系统；
• CMake: Build：运行 cmake --build build 进行编译；
• CMake: Clean：清理构建目录（仅限 Unix-like 系统）；
  • 如果你在 Windows 上使用 CMD 或 PowerShell，可以用如下命令代替：

rd /s /q build && mkdir build

---

✅ 3. launch.json

{"version": "0.2.0","configurations": [{"name": "GDB Debug","type": "cppdbg","request": "launch","program": "${workspaceFolder}/build/myapp.exe","args": [],"stopAtEntry": false,"cwd": "${workspaceFolder}","environment": [],"externalConsole": true,"MIMode": "gdb","miDebuggerPath": "C:\\msys64\\mingw64\\bin\\gdb.exe"}]
}

⚙️ 说明：

• "program" 是你要调试的可执行文件路径；
• "miDebuggerPath" 根据你安装的 GDB 路径修改；
  • 如果你用的是 MSYS2 或 MinGW-w64，请确认 gdb.exe 存在；
  • 如果你用的是 MSVC（Visual Studio 编译器），则需要使用 Windows Debugger 插件。

---

🧪 使用方法

1. 把这三个文件放到你的项目根目录下的 .vscode/ 文件夹中；
2. 确保你的项目根目录有 CMakeLists.txt；
3. 按 Ctrl+Shift+P，输入并运行 CMake: Configure；
4. 按 Ctrl+Shift+B 构建项目；
5. 按 F5 启动调试器；

---

📦 可选建议（针对 Qt 项目）

如果你是 Qt 项目，确保 CMakeLists.txt 中包含以下内容：

set(CMAKE_INCLUDE_CURRENT_DIR ON)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUI ON)find_package(Qt6 COMPONENTS Widgets REQUIRED)target_link_libraries(myapp PRIVATE Qt6::Widgets)

---

📝 提示：路径问题要特别注意！

• miDebuggerPath 要根据你实际安装路径填写；
• program 要指向你生成的 .exe 文件路径；
• 如果你不知道路径，可以在终端中运行：

which gdb

---

🎁 小福利：一键创建脚本（可选）

如果你经常新建项目，可以写一个 Python 或 Shell 脚本来自动生成 .vscode 文件夹和配置。
VSCode 工作区配置文件通用模板创建脚本