VS Code 配置 C++ 开发环境的关键是安装 MinGW-w64 编译器、配置 tasks.json 和 launch.json 文件,并使用 Code Runner 实现一键编译运行;需正确设置环境变量、JSON 参数及调试路径。

VS Code 配置 C++ 开发环境不难,关键在装对工具、配好文件、理清流程。核心是:安装 MinGW-w64(或 MSVC)、配置 tasks.json 和 launch.json、用 Code Runner 简化一键运行。
一、安装 C++ 编译器(推荐 MinGW-w64)
Windows 上最轻量、兼容性最好的选择是 MinGW-w64(不是旧版 MinGW)。它提供 g++ 编译器,支持 C++17/20,且无需 Visual Studio 安装包。
- 去官网 mingw-w64.org 下载最新在线安装器(如
mingw-w64-install.exe) - 安装时选:架构 x86_64、线程模型 posix、异常处理 seh(Win10/11 推荐)
- 安装路径别带中文和空格,例如
D:\mingw64 - 把
D:\mingw64\bin添加到系统环境变量PATH中(重启终端生效) - 打开 PowerShell 或 CMD,输入
g++ --version,看到版本号即成功
二、安装 VS Code 必备扩展
仅需 3 个扩展,不装多余插件:
- C/C++(Microsoft 官方):提供智能提示、跳转、调试支持
- Code Runner(Jun Han):点右上角“播放键”即可编译+运行,适合快速验证代码
- Chinese (Simplified) Language Pack(可选):中文界面支持
安装后重启 VS Code。
立即学习“C++免费学习笔记(深入)”;
三、配置一键编译运行(tasks.json + Code Runner)
让 Ctrl+Alt+N 或点击“运行”直接生成并执行 a.exe,无需手动敲命令。
- 打开一个 .cpp 文件 → 按
Ctrl+Shift+P→ 输入Tasks: Configure Default Build Task→ 选g++.exe build active file - 会自动生成
.vscode/tasks.json,确认args包含:"-g"(生成调试信息)、"-O0"(关闭优化,便于调试)、"-std=c++17"(指定标准) - 接着配置 Code Runner:按
Ctrl+,打开设置 → 搜索code-runner.executorMap→ 点击“在 settings.json 中编辑” → 添加或修改 C++ 配置:
"code-runner.executorMap": {
"cpp": "cd $dir && g++ -std=c++17 -g $fileName -o $fileNameWithoutExt.exe && $dir$fileNameWithoutExt.exe"
}
保存后,任意 .cpp 文件右键 → “Run Code”,或按 Ctrl+Alt+N,即可一键编译并运行。
四、调试 C++ 程序(launch.json)
想打断点、看变量、单步执行?需要 launch.json 启动调试器。
- 按
Ctrl+Shift+D进入调试视图 → 点“创建 launch.json 文件” → 选环境 C++ (GDB/LLDB) → 选 GDB(对应 MinGW-w64) - 确保生成的
launch.json中:"miDebuggerPath"指向你的gdb.exe(如"D:\\mingw64\\bin\\gdb.exe")"program"是编译后的可执行文件路径(如"${fileDirname}\\${fileBasenameNoExtension}.exe")"externalConsole"设为true(否则控制台一闪而退) - 写好代码,按
F9打断点 →F5启动调试
不复杂但容易忽略:每次新建文件夹写 C++,记得先用 VS Code 打开整个文件夹(不是单个文件),这样才能正确读取 .vscode 配置。编译出错时优先检查 g++ 是否能命令行调用、路径有没有中文、JSON 文件有没有多逗号。











