如果您在 Visual Studio Code 中配置 C++ 开发环境时遇到编译器无法识别、调试失败或 CMake 工具链未生效等问题，通常是由于 MinGW 安装路径未正确纳入系统变量、VSCode 的 JSON 配置文件未匹配本地工具链，或 CMake 生成器与编译器不兼容所致。以下是解决此问题的步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装并验证 MinGW-w64（Windows）或使用 Homebrew 安装 GCC（macOS）
该步骤确保系统具备可用的 C++ 编译器，并能被 VSCode 和 CMake 正确调用。MinGW-w64 提供 Windows 下的 GCC 兼容工具链；macOS 用户则需通过 Homebrew 安装原生 GCC 或使用 Clang（系统默认），但为保持与 Windows 环境行为一致，推荐安装 GCC。
1、打开终端（macOS）或命令提示符（Windows）。
立即学习“C++免费学习笔记（深入）”；
2、Windows 用户下载 MinGW-w64 官方构建版本（如 https://www.mingw-w64.org/downloads/），运行安装程序，勾选 x86_64、posix、seh 三要素组合，安装路径避免含空格或中文。
3、macOS 用户执行：brew install gcc，安装完成后运行 gcc-14 --version 验证（版本号以实际 brew 安装为准）。
4、将 MinGW-w64 的 bin 目录（如 C:\mingw64\bin）或 Homebrew GCC 的 bin 路径（如 /opt/homebrew/bin）添加至系统 PATH 环境变量。
二、配置 VSCode 的 C/C++ 扩展与 c_cpp_properties.json
该步骤使 IntelliSense 能准确解析头文件路径、识别语法特性，并为调试提供正确的编译器路径。C/C++ 扩展依赖此文件定位标准库和工具链。
1、在 VSCode 中按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并选择 “C/C++: Edit Configurations (UI)”。
2、在界面中设置 Compiler path：Windows 填入 C:\mingw64\bin\g++.exe，macOS 填入 /opt/homebrew/bin/g++-14。
3、确认 IntelliSense mode 设置为与编译器匹配的模式，例如 gcc-x64 或 clang-x64。
4、保存后，VSCode 自动在工作区 .vscode/c_cpp_properties.json 中写入配置。
三、配置 tasks.json 以支持手动编译
该步骤定义 VSCode 内置终端中执行的编译命令，使 Ctrl+Shift+B 可直接调用 g++ 编译源文件，绕过 CMake 进行快速验证。
1、按 Ctrl+Shift+P 输入 “Tasks: Configure Task”，选择 “Create tasks.json file from template”，再选 “Others”。
2、将生成的 tasks.json 替换为以下内容（以 macOS 为例，Windows 用户需调整路径及可执行文件名）：
3、在 args 字段中确保包含 -std=c++17、-g（启用调试信息）和 -o ${fileDirname}/${fileBasenameNoExtension}（输出可执行文件）。
4、保存后，在任意 .cpp 文件中按 Ctrl+Shift+B 即可触发编译。
四、配置 CMake Tools 扩展与 settings.json
该步骤启用 VSCode 对 CMake 项目的完整支持，包括自动检测编译器、配置构建类型、启动构建与调试会话。CMake Tools 扩展必须与本地 CMake 版本及选定 Kit 匹配。
1、在 VSCode 扩展市场中安装 CMake Tools（由 Microsoft 官方维护）。
2、在项目根目录创建 CMakeLists.txt，内容至少包含 cmake_minimum_required(VERSION 3.20) 与 project(MyProject)。
3、按 Ctrl+Shift+P 输入 “CMake: Select a Kit”，从列表中选择已识别的 MinGW 或 GCC Kit（名称中应含 GCC 14.2.0 或类似标识）。
4、再次调用 “CMake: Configure” 触发 CMake 配置过程，观察底部状态栏是否显示 Ready 并生成 build 文件夹。
五、配置 launch.json 实现 GDB/LLDB 调试
该步骤建立 VSCode 与底层调试器（GDB for MinGW，LLDB for macOS）之间的连接，使断点、变量监视与单步执行功能生效。调试器路径和预设参数必须与所选 Kit 严格一致。
1、确保已安装调试器：Windows 用户 MinGW-w64 自带 gdb.exe；macOS 用户执行 brew install gdb 或使用系统自带 lldb（推荐）。
2、按 Ctrl+Shift+P 输入 “Debug: Open launch.json”，选择环境为 C++ (GDB/LLDB)。
3、在生成的 launch.json 中，将 miDebuggerPath 设为 C:\mingw64\bin\gdb.exe（Windows）或 /usr/bin/lldb（macOS）。
4、确认 program 字段指向 CMake 构建生成的可执行文件路径，例如 ${command:cmake.launchTargetPath}。
