VSCode运行C++报错绝大多数源于调试流程断链，需按“tasks.json生成→args正确→preLaunchTask与label匹配→program路径一致→c_cpp_properties.json配置”顺序排查。
VSCode运行C++报错，绝大多数情况不是代码问题，而是调试流程断在了“编译→生成可执行文件→启动调试器”这个链路上的某一处。F5失败、launch: program 'xxx' does not exist、command 'g++' not found、终端一闪而过——这些现象背后有明确的因果路径，按顺序排查就能快速定位。
tasks.json根本没生成或位置错了
VSCode不会自动创建tasks.json，你点“运行构建任务”就报“找不到任务”，大概率是因为项目根目录下压根没有.vscode/tasks.json这个文件。
- 必须用 VSCode 打开**整个文件夹**（File → Open Folder），而不是只打开单个
.cpp文件；否则.vscode/会被建在错误层级 - 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Tasks: Configure Task→ 选Create tasks.json from template→Others - 如果已有
.vscode/但没tasks.json，直接删掉整个.vscode/目录再重来一次，避免旧缓存干扰 -
tasks.json必须放在项目根目录下的.vscode/子目录里，不能放在源码同级或子目录中
args写错导致g++根本没执行
很多人把终端里能跑的g++ main.cpp -o main直接复制进args，结果 VSCode 显示“任务已启动”，实际什么都没干——因为args是数组，不是 shell 命令行。
-
args里每个参数必须单独一项："args": ["-g", "${file}", "-o", "${fileDirname}/${fileBasenameNoExtension}"]，不能写成"g++ ${file} -o ..." - Windows 用户别只写
"command": "g++"，系统 PATH 在 task 环境里不一定生效；建议用绝对路径，如"C:\mingw64\bin\g++.exe" - 确认终端里能直接运行
g++ --version，否则先配好环境变量，VSCode 不会替你解决 PATH - 编译多个源文件时，
args里要列全："${fileDirname}/*.cpp"或显式写"main.cpp", "util.cpp"，不能只留"${file}"
launch.json的program和preLaunchTask不匹配
launch.json里program字段指向的路径，必须和tasks.json最终生成的可执行文件**完全一致**；同时preLaunchTask值必须和tasks.json里label字段**逐字相同**（包括空格、大小写、标点）。
-
program推荐写相对路径："${fileDirname}/${fileBasenameNoExtension}"（Linux/macOS）或"${fileDirname}\${fileBasenameNoExtension}.exe"（Windows），它自动适配当前文件所在目录 -
preLaunchTask必须严格等于tasks.json中某个 task 的label值，例如"label": "g++ build active file"，那这里就得填"g++ build active file"，多一个空格都失败 - Windows 下注意：如果
tasks.json输出的是main.exe，program就必须带.exe后缀；不带就报not found - 改完
tasks.json后，按Ctrl+Shift+P→Tasks: Run Task，看列表里是否出现你定义的label——没出现说明配置未加载或有语法错误
头文件报错不是编译失败，而是IntelliSense假报
红色波浪线提示#include 找不到，但Ctrl+Shift+B却能成功编译，这是最典型的“c_cpp_properties.json没配对，但编译器本身能找到头文件”的情况。
-
c_cpp_properties.json只影响代码补全和语法检查（IntelliSense），**不影响实际编译**；编译靠的是tasks.json里的args和系统环境 - 如果编译成功但编辑器标红，重点检查
c_cpp_properties.json里的compilerPath是否指向真实g++.exe，以及includePath是否包含标准库路径（如"C:/mingw64/x86_64-w64-mingw32/include/c++"） - 第三方头文件路径必须在
tasks.json的args里用-I显式传给g++，例如"-I", "D:/mylib/include"；只加在c_cpp_properties.json里是无效的 - 修改
c_cpp_properties.json后，按Ctrl+Shift+P→C/C++: Reset IntelliSense Database强制刷新缓存
最容易被忽略的一点：VSCode 的任务和调试器各自维护一套环境变量，tasks.json里不显式声明PATH，它就可能读不到你系统里配好的编译器；而launch.json里不指定miDebuggerPath，Windows 下就默认找gdb，但你装的可能是gdb.exe或vsdbg.exe——这些细节不手动对齐，整个链路就会静默断裂。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
