VSCode本身不带编译器和调试器，必须手动配置tasks.json和launch.json；tasks.json需含"group":"build"、"isDefault":true及"problemMatcher"，launch.json中"program"路径须与tasks输出一致且设"preLaunchTask"。
直接说结论：VSCode 本身不带编译器、不带调试器、也不自动配路径，装完插件不手动写 tasks.json 和 launch.json，点运行必失败。错误不是 VSCode 的问题，是你没告诉它“用什么编译”“编译成啥”“去哪找调试器”。
tasks.json 必须手写，别信自动检测
VSCode 不会猜你用 g++ 还是 clang++，也不会自动加 -std=c++20 或第三方头文件路径。靠“配置任务”弹窗生成的模板常漏关键字段：
- 缺
"group": "build"→Ctrl+Shift+B按了没反应 - 漏
"problemMatcher": ["$gcc"]→ 编译报错只在终端刷屏，双击不能跳转到出错行 -
"args"里没写-g→ 后续调试时变量全显示为<optimized out></optimized>
最小可用示例（单文件编译）：
{
"version": "2.0.0",
"tasks": [{
"type": "shell",
"label": "g++ build",
"command": "g++",
"args": [
"-g",
"${file}",
"-o",
"${fileDirname}/${fileBasenameNoExtension}",
"-std=c++20"
],
"group": "build",
"problemMatcher": ["$gcc"]
}]
}
Windows 用户注意：command 写 "g++" 前提是已把 MinGW 的 bin/ 加进系统 PATH；否则得写绝对路径，比如 "C:/mingw64/bin/g++.exe"。
立即学习“C++免费学习笔记（深入）”；
launch.json 的 program 路径必须和 tasks.json 输出一致
launch.json 不是独立配置，它依赖 tasks.json 的输出结果。常见错误：
-
"program"指向"${fileDirname}/a.out"，但tasks.json实际输出的是"main.exe"→ 启动调试时报“找不到可执行文件” - 没设
"preLaunchTask": "g++ build"→ 每次改完代码要手动按Ctrl+Shift+B编译，否则调试的是旧二进制 -
"externalConsole": true在 Windows 下必须开 → 否则控制台窗口一闪而过，输入卡死
示例片段（适配上面的 tasks.json）：
{
"configurations": [{
"name": "(gdb) 启动",
"type": "cppdbg",
"request": "launch",
"program": "${fileDirname}/${fileBasenameNoExtension}",
"args": [],
"stopAtEntry": false,
"cwd": "${fileDirname}",
"environment": [],
"externalConsole": true,
"MIMode": "gdb",
"miDebuggerPath": "gdb",
"preLaunchTask": "g++ build"
}]
}
Linux/macOS 用户若用 gdb，"miDebuggerPath" 可简写为 "gdb"（前提是 gdb --version 能正常执行）；Windows 下建议写绝对路径，如 "C:/mingw64/bin/gdb.exe"。
c_cpp_properties.json 改完必须手动“重新扫描”
这个文件管 IntelliSense（跳转、补全、红线提示），但 VSCode 不会热重载它。改完 "compilerPath" 或 "includePath" 后：
- 右下角状态栏点击 C/C++ 图标
- 选 “Reset IntelliSense database” 或 “Re-scan workspace”
- 或者关掉文件夹再重开
常见坑点：
-
"compilerPath"写成"g++"（命令名）而不是真实路径（如"C:/mingw64/bin/g++.exe"）→ 头文件路径解析失败，#include <vector>一直标红 - macOS 上用
brew install gcc，实际命令是g++-14，"compilerPath"就得填"/opt/homebrew/bin/g++-14" - 多标准混用项目，
"cppStandard"必须显式写死，比如"c++20"，别留默认值
最关键的其实是：所有 JSON 文件都得放在项目根目录下的 .vscode/ 文件夹里，且文件名一个字母都不能错。少个点、大小写不对、JSON 格式多逗号，VSCode 都会静默忽略，然后你花半小时查为什么调试启动不了——其实只是 launch.json 被当成普通文本没加载。
