VS Code 需手动配置编译器、tasks.json 和 launch.json 才能运行调试 C++ 项目；必须先安装 g++/MinGW/clang++ 并验证版本，再安装 C/C++ 与 CMake Tools 等扩展，确保 tasks.json 含 -g 参数、launch.json 中 preLaunchTask 与 task label 一致。
VS Code 本身不是 C++ IDE，它需要手动配置编译器、构建工具和调试器才能真正跑起来 C++ 项目。没配对 tasks.json、launch.json 或漏装 g++ / clang++，写完 main.cpp 点运行只会报错“终端中找不到 g++”或“无法启动调试会话”。
确认系统已安装可用的 C++ 编译器
VS Code 不自带编译器，必须先在系统层面装好 g++（Linux/macOS）或 MinGW-w64（Windows），否则后续所有配置都无效。
- Windows 用户别只下 Visual Studio Installer 后就以为“有编译器了”——VS Code 默认不识别 MSVC 的
cl.exe，除非你额外配vcvarsall.bat环境，建议新手直接用MinGW-w64（官网下载 installer，勾选x86_64-posix-seh和add to PATH） - macOS 用户执行
xcode-select --install装命令行工具即可获得clang++；如需g++，用brew install gcc，注意装完后g++-14这类带版本号的命令才是真实可执行名 - 验证是否成功：终端运行
g++ --version或clang++ --version，必须有输出；如果提示 command not found，请先解决 PATH 问题
安装并启用必要 VS Code 扩展
光靠默认界面写 C++ 是纯文本编辑，关键功能全靠扩展补足。
- 必装
C/C++（Microsoft 官方扩展，提供智能提示、跳转、定义查看，依赖c_cpp_properties.json配置头文件路径） - 必装
CMake Tools（如果你用 CMake 构建，它能自动检测CMakeLists.txt并生成构建目录） - 可选但强烈推荐
Code Runner（快速右键运行单文件，适合练手，但它绕过tasks.json，不适合多文件项目） - 别装“C++ Compile Runner”之类小众扩展——它们常和官方 C/C++ 扩展冲突，导致 IntelliSense 失效
手动配置 tasks.json 实现一键编译
tasks.json 定义 VS Code 怎么调用编译器，不配它，Ctrl+Shift+B 就是摆设。
立即学习“C++免费学习笔记（深入）”；
- 按
Ctrl+Shift+P→ 输入 “Tasks: Configure Task” → 选 “Create tasks.json file from template” → 选 “Others” - 替换内容为以下适配
g++的最小可用配置（注意args中的-g必须加，否则launch.json调试会失败）：
{
"version": "2.0.0",
"tasks": [
{
"type": "shell",
"label": "g++ build active file",
"command": "/usr/bin/g++",
"args": [
"-g",
"${file}",
"-o",
"${fileDirname}/${fileBasenameNoExtension}"
],
"options": {
"cwd": "${fileDirname}"
},
"problemMatcher": ["$gcc"],
"group": "build"
}
]
}
- Windows 用户把
"command": "/usr/bin/g++"改成"command": "g++"（前提是 MinGW 已加进系统 PATH） - 如果项目含多个
.cpp文件，args需扩展为"${fileDirname}/*.cpp"或改用 CMake
配置 launch.json 才能 F5 调试
没有 launch.json，点调试按钮只会弹窗说 “Please configure a launch configuration”。它和 tasks.json 是绑定关系——preLaunchTask 必须与 tasks.json 里 label 完全一致。
- 按
Ctrl+Shift+P→ 输入 “Debug: Open launch.json” → 选 “C++ (GDB/LLDB)” → 选 “g++ build and debug active file” - 检查生成的
launch.json中program字段是否指向编译产出的可执行文件（如"${fileDirname}/${fileBasenameNoExtension}"），且preLaunchTask值和tasks.json中label严格匹配 - macOS 上若用
clang++编译，launch.json的miDebuggerPath可能需设为"lldb"；Linux 下通常用"gdb" - 断点不生效？大概率是
tasks.json没加-g参数，或launch.json的program路径写错了
最易被忽略的一点：每次换编译器（比如从 g++ 切到 clang++）、换操作系统、甚至升级了 MinGW 版本，都要重新核对 tasks.json 的 command 和 args——路径、参数名、输出格式都可能变。别迷信网上抄来的配置，始终以 g++ --help 输出为准。
