在 VS Code 中配置 C++ 开发环境主要分为安装编译器、配置 VS Code 插件、编写配置文件三个核心步骤，以下是全平台（Windows/macOS/Linux）的详细教程，兼顾新手友好和实用性。
一、前置准备：安装 C++ 编译器
VS Code 本身只是编辑器，需要依赖编译器（如 GCC/Clang/MinGW）来编译运行 C++ 代码，先根据系统安装对应编译器：
1. Windows 系统（推荐 MinGW-w64）
- 下载 MinGW-w64：
不建议用老旧的 MinGW，推荐从 MinGW-w64 官方下载页 下载（选择
x86_64-posix-seh版本，适配 64 位系统），或用包管理器更便捷：- 方式 1（推荐）：安装 Chocolatey，然后在管理员终端执行：
bash运行
choco install mingw -y - 方式 2：手动解压下载的 MinGW 压缩包（如
mingw64文件夹），放到固定路径（如D:\mingw64）。
- 方式 1（推荐）：安装 Chocolatey，然后在管理员终端执行：
- 配置环境变量：
找到 MinGW 的
bin目录（如D:\mingw64\bin），添加到系统环境变量Path中：- 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」→ 系统变量「Path」→「新建」→ 粘贴路径。
- 验证安装：
打开 cmd / 终端，输入
g++ --version，若显示版本号则成功（如g++ (x86_64-posix-seh-rev0, Built by MinGW-W64 project) 13.2.0）。
2. macOS 系统（Clang）
macOS 自带 Clang 编译器，只需安装 Xcode 命令行工具：
- 打开终端，执行：
bash运行
xcode-select --install - 验证：输入
clang++ --version，显示版本号即成功。
- 验证：
g++ --version。
二、VS Code 安装 C++ 插件
打开 VS Code，在左侧「扩展商店」（快捷键
Ctrl+Shift+X）搜索并安装以下核心插件：- C/C++（微软官方）：提供语法高亮、智能提示、调试、编译支持。
- Code Runner（可选）：一键运行代码（右键 / 快捷键
Ctrl+Alt+N），新手友好。
三、编写项目配置文件（关键）
VS Code 通过
tasks.json（编译任务）和 launch.json（调试配置）来管理 C++ 项目，建议按「新建文件夹→创建配置文件」的流程操作：步骤 1：新建项目文件夹
- 新建一个文件夹（如
CppProject），用 VS Code 打开（「文件」→「打开文件夹」）。 - 在文件夹内新建
test.cpp，写入测试代码：cpp运行
步骤 2：生成 tasks.json（编译配置）
tasks.json 用于告诉 VS Code 如何调用编译器编译代码：
- 按下
Ctrl+Shift+B，选择「创建 tasks.json 文件」→ 选择「C/C++: g++.exe 生成活动文件」（Windows）/「C/C++: clang++ 生成活动文件」（macOS）/「C/C++: g++ 生成活动文件」（Linux）。 - 生成的
tasks.json示例（Windows）：json{"version": "2.0.0","tasks": [{"type": "cppbuild","label": "C/C++: g++.exe 生成活动文件","command": "g++.exe","args": ["-fdiagnostics-color=always","-g", // 保留调试信息"${file}", // 编译当前打开的文件"-o", // 输出可执行文件"${fileDirname}\\${fileBasenameNoExtension}.exe"],"options": {"cwd": "${fileDirname}"},"problemMatcher": ["$gcc"],"group": {"kind": "build","isDefault": true // 设置为默认编译任务},"detail": "编译器: g++.exe"}] }
步骤 3：生成 launch.json（调试配置）
launch.json 用于配置调试器（GDB/LLDB），支持断点调试：
- 按下
F5，选择「C++ (GDB/LLDB)」→ 选择「g++.exe - 生成和调试活动文件」（Windows）/「clang++ - 生成和调试活动文件」（macOS/Linux）。 - 生成的
launch.json示例（Windows）：json{"version": "0.2.0","configurations": [{"name": "g++.exe - 生成和调试活动文件","type": "cppvsdbg", // Windows 调试器（mingw用gdb则改为"cppvsdbg"→"gdb"）"request": "launch","program": "${fileDirname}\\${fileBasenameNoExtension}.exe", // 要调试的可执行文件"args": [],"stopAtEntry": false, // 是否在main函数入口暂停"cwd": "${fileDirname}","environment": [],"externalConsole": true, // 是否弹出终端窗口运行"MIMode": "gdb","miDebuggerPath": "gdb.exe", // gdb路径（mingw的bin目录下）"preLaunchTask": "C/C++: g++.exe 生成活动文件", // 调试前先执行编译任务"setupCommands": [{"description": "为 gdb 启用整齐打印","text": "-enable-pretty-printing","ignoreFailures": true}]}] }
四、编译 & 运行 & 调试
1. 编译代码
- 方式 1：按下
Ctrl+Shift+B，自动执行 tasks.json 中的编译任务，生成可执行文件（如test.exe）。 - 方式 2：安装 Code Runner 后，右键代码编辑区 →「Run Code」（或
Ctrl+Alt+N），一键编译运行（输出在 VS Code 终端）。
2. 运行代码
- 方式 1：在 VS Code 终端（「终端」→「新建终端」），输入
./test.exe（Windows）/./test（macOS/Linux）运行。 - 方式 2：Code Runner 一键运行（自动输出结果）。
3. 调试代码
- 在代码行号左侧点击添加断点（小红点）。
- 按下
F5启动调试，支持：- 单步执行（
F10下一步，F11步入函数）； - 查看变量（左侧「运行和调试」面板）；
- 监视表达式（添加自定义表达式监控值变化）。
- 单步执行（
五、常见问题解决
- 「g++.exe 不是内部或外部命令」：
→ 检查 MinGW 的
bin目录是否加入环境变量，重启 VS Code / 终端。 - 调试时终端不弹出：
→ 在 launch.json 中设置
"externalConsole": true（Windows），或检查终端路径。 - 中文乱码：
→ Windows：在 tasks.json 的 args 中添加
-fexec-charset=GBK；→ macOS/Linux：添加-fexec-charset=UTF-8。 - 多文件编译：
→ 修改 tasks.json 的
${file}为${workspaceFolder}/*.cpp（编译所有 cpp 文件），或指定具体文件列表。
六、进阶优化（可选）
- 安装
C/C++ Extension Pack：一键安装微软官方的 C++ 相关插件合集。 - 配置
settings.json：自定义代码格式化、智能提示等（按下Ctrl+,打开设置，搜索「C++」调整）。 - 使用 CMake：复杂项目推荐用 CMake 管理，安装「CMake」「CMake Tools」插件，自动生成编译配置。