VS Code需手动配置C++编译调试环境：先安装g++/clang++并加入PATH，再装C/C++插件、配置c_cpp_properties.json指定编译器路径和标准，通过tasks.json实现一键编译（含-g参数），最后用launch.json配置调试，确保preLaunchTask与task标签一致且externalConsole为true。
VS Code 本身不带 C++ 编译器和调试器，必须手动配置外部工具链；没装 g++ 或 clang++，写完代码也运行不了。
确认系统已安装可用的 C++ 编译器
VS Code 只是编辑器，真正编译靠系统命令行工具。Windows 用户最容易卡在这一步：装了 VS Code，但没装 MinGW-w64 或没把 g++.exe 加进 PATH。
- 在终端运行
g++ --version或clang++ --version，有输出才说明可用 - Windows 推荐用 MinGW-w64（选
x86_64-posix-seh版本），安装后把bin/目录加进系统环境变量PATH - macOS 用
xcode-select --install安装命令行工具即可获得clang++ - Linux 用户通常已有
g++，若没有：Ubuntu/Debian 执行sudo apt install g++，CentOS/RHEL 用sudo yum install gcc-c++
安装必要插件并设置 c_cpp_properties.json
仅装 C/C++ 插件（Microsoft 官方）还不够，它需要知道头文件在哪、用哪个标准、是否启用 C++17 等——这些全靠 c_cpp_properties.json 告诉它。
- 必须安装插件：
C/C++（id: ms-vscode.cpptools） - 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入C/C++: Edit Configurations (UI)，图形化生成配置 - 关键字段要核对：
-
"compilerPath"必须指向你实际的g++或clang++路径，例如"C:\msys64\ucrt64\bin\g++.exe" -
"intelliSenseMode"要匹配编译器，gcc-x64对应g++，clang-x64对应clang++ -
"cStandard"和"cppStandard"建议设为"c17"和"c++17"，避免默认c++14导致新语法标红
-
用 tasks.json 实现一键编译
不配 tasks.json，你就得切到终端手动敲 g++ main.cpp -o main——这违背“一键运行”的初衷。
立即学习“C++免费学习笔记（深入）”；
- 在项目根目录建
.vscode/tasks.json，内容如下：
{
"version": "2.0.0",
"tasks": [
{
"type": "shell",
"label": "g++ build active file",
"command": "g++",
"args": [
"-g",
"${file}",
"-o",
"${fileDirname}/${fileBasenameNoExtension}"
],
"group": "build",
"problemMatcher": ["$gcc"]
}
]
}
-
"problemMatcher": ["$gcc"]很关键：它让错误信息可点击跳转到出错行 - 如果用
clang++，把"command"和"args"中的g++换成clang++即可 - 按
Ctrl+Shift+B运行该 task，生成可执行文件
配置 launch.json 启动调试
调试失败最常见的原因是：没生成带调试信息的二进制，或 launch.json 的 program 路径写错了。
- 确保
tasks.json的args包含-g（如上例），否则断点无效 -
launch.json中"program"必须是编译后生成的可执行文件路径，例如"${fileDirname}/${fileBasenameNoExtension}" - Windows 下若用 MinGW，
"miDebuggerPath"需指向gdb.exe，如"C:\msys64\ucrt64\bin\gdb.exe" - 一个最小可用配置示例：
{
"version": "0.2.0",
"configurations": [
{
"name": "g++ launch",
"type": "cppdbg",
"request": "launch",
"program": "${fileDirname}/${fileBasenameNoExtension}",
"args": [],
"stopAtEntry": false,
"cwd": "${fileDirname}",
"environment": [],
"externalConsole": true,
"MIMode": "gdb",
"miDebuggerPath": "gdb",
"setupCommands": [
{
"description": "Enable pretty-printing",
"text": "-enable-pretty-printing",
"ignoreFailures": true
}
],
"preLaunchTask": "g++ build active file"
}
]
}
-
"preLaunchTask"值必须和tasks.json中的"label"完全一致 -
"externalConsole": true在 Windows 上很重要，否则控制台一闪而退，看不到cin或printf输出
最常被忽略的是编译器路径和调试器路径是否真实存在、是否在 PATH 中；哪怕只差一个反斜杠，VS Code 就会静默失败，既不报错也不运行。
