VSCode本身不带C++运行能力，所有“运行失败”问题几乎都卡在编译器没被系统或VSCode识别上；核心判断标准是g++ --version和gdb --version在任意终端中能直接执行并返回版本号，否则后续配置无效。
VSCode本身不带C++运行能力，所有“运行失败”问题几乎都卡在编译器没被系统或VSCode识别上。核心判断标准只有一条：g++ --version 和 gdb --version 在任意终端（CMD、PowerShell、VSCode内置终端）中都能直接执行并返回版本号——否则后续所有配置都是空中楼阁。
为什么g++总提示“不是内部或外部命令”
这不是VSCode的问题，是Windows根本找不到g++.exe。常见原因有三个：
- MinGW-w64实际安装路径没加进系统PATH，比如装在
C:msys64mingw64in，但PATH里写的是C:mingw64in或漏了in后缀 - 安装时用了中文路径（如
D:软件mingw64），Windows环境变量对中文支持不稳定，尤其在VSCode终端里容易失效 - PATH修改后没重启VSCode——改完环境变量必须完全关闭再重开VSCode，仅重启终端无效
验证方式：打开全新CMD窗口，直接输入g++ --version。能出结果，说明系统层通了；如果不行，别往下配VSCode，先修PATH。
c_cpp_properties.json里compilerPath填什么
这个路径不是用来“让代码编译”，而是告诉C/C++扩展：你用的哪个编译器，以便提供正确的语法检查、头文件索引和智能提示。填错会导致#include标红、函数跳转失效，但不影响实际编译运行。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 必须指向
g++.exe（不是gcc.exe），例如C:\msys64\mingw64\bin\g++.exe - 路径中的反斜杠要双写（
\），单个在JSON里是转义符，会导致解析失败 - 不要填
g++命令名，必须是绝对路径；也不能用${env:PATH}这类变量，扩展不识别 - 如果用MSYS2安装，推荐选UCRT64环境，对应路径是
C:\msys64\ucrt64\bin\g++.exe，兼容性比mingw64更稳
launch.json调试时miDebuggerPath指向gdb.exe却报错
GDB版本不匹配是最隐蔽的坑。VSCode的C/C++扩展对GDB有最低版本要求（v8.0+），但更重要的是ABI兼容性：
- 用MSYS2安装的
mingw-w64-x86_64-gdb，必须搭配同环境下的g++.exe，混用WinLibs的GDB和MSYS2的g++大概率触发Unable to start debugging - 检查GDB是否支持Python脚本：
gdb --batch -ex "python print('ok')"，如果报错Python scripting is not supported，说明GDB编译时没启Python支持，无法加载VSCode所需的pretty-printer -
miDebuggerPath必须是gdb.exe全路径，且不能带空格或括号；若路径含空格（如Program Files），务必用双引号包裹整个路径字符串
一个可靠做法：在MSYS2 UCRT64终端里执行which gdb，复制输出路径，粘贴到launch.json中，确保来源一致。
Code Runner插件跑C++为什么总出错
Code Runner默认用g++ $filename -o $filename_without_ext编译，看似简单，实则埋雷：
- 不自动加
-std=c++17等标准参数，遇到std::filesystem等新特性直接报错 - 不处理多文件项目，
#include "xxx.h"跨文件引用时找不到头文件 - 输出目录固定为当前文件夹，若源文件在子目录，生成的
.exe会散落各处，调试时program路径难写死
真想图快，建议禁用Code Runner，改用VSCode内置的“Tasks”机制，创建一个tasks.json，明确指定-std=c++20 -O0 -g等参数，并统一输出到./build/目录。这样既可控，又和launch.json调试路径天然对齐。
最常被忽略的一点：所有配置文件（c_cpp_properties.json、launch.json、tasks.json）都必须放在项目根目录下的.vscode/文件夹里，而不是用户目录或全局设置。VSCode按工作区加载，跨项目复用配置基本等于白配。
