✨ 导语

很多刚开始学 C++ 的同学会选择 VSCode 作为编辑器，但 VSCode 默认并不内置 C++ 编译环境。本篇教程将从零开始，带你在 Windows 系统上配置完整的 VSCode + MinGW-w64 C++ 开发环境，解决中文文件名无法编译的问题，并通过实际案例一步步演示编译与调试流程。无论你是新手还是回炉老手，这篇都值得收藏！

---

VSCode 中配置 C++ 开发环境的详细指南（Windows 平台）

C++ 凭借其高性能和广泛的应用，在软件开发领域始终占据着重要地位。VSCode 是一款轻量、强大的代码编辑器，深受开发者喜爱。但默认情况下，它并不支持 C++ 开发，需要我们手动配置。

这篇教程将手把手教你在 Windows 上搭建 VSCode 的 C++ 编程环境，一步到位，干净利落！

---

一、安装 VSCode

1. 访问 VSCode 官网

2. 根据系统下载 32/64 位版本；

3. 安装时建议勾选：

   • 创建桌面快捷方式；
   • 添加到系统路径（Add to PATH）。

---

二、安装 C++ 编译器（MinGW-w64）

Windows 推荐使用 MinGW-w64，它是 GCC 的 Windows 移植版本，稳定易用。

为了方便安装，我将 MinGW-w64 打包上传至云盘：

🔗 下载地址：https://www.123684.com/s/G0gcVv-aVMK
🔐 提取码：NO3d

安装步骤：

• 解压至如 C:\mingw-w64；

• 配置环境变量：

  • 系统属性 → 环境变量 → Path → 添加 C:\mingw-w64\...\bin 路径；

• 打开命令行输入：

  g++ --version
  

  出现版本号即配置成功。

---

三、安装 VSCode 的 C++ 插件

• 打开 VSCode，按 Ctrl+Shift+X；
• 搜索并安装 C/C++（Microsoft）；
• 提供语法高亮、智能补全、调试等功能。

---

四、自动生成 launch.json 和 tasks.json

最新版 VSCode 会在你运行/调试 C++ 代码时自动生成相关配置文件：

操作：

1. 创建文件夹（如 cpp_project），新建 main.cpp：

   #include <iostream>
   int main() {
       std::cout << "Hello, World!" << std::endl;
       return 0;
   }
   

2. 按 F5 启动调试，会自动生成 launch.json；

3. 按 Ctrl+Shift+B 编译，会生成 tasks.json。

---

五、中文文件名的兼容问题及解决方案

C++ 编译器不推荐使用中文文件名，会导致 .exe 生成失败。我们可以在 tasks.json 中自定义输出文件名：

打开 .vscode/tasks.json，修改如下：

"args": [
  "-fdiagnostics-color=always",
  "-g",
  "${file}",
  "-o",
  "${fileDirname}\\hello_world.exe"
]

可选：修改输出目录为 D:\cpp_output

"-o", "D:\\cpp_output\\hello_world.exe"

---

六、测试环境是否配置成功

• 打开 main.cpp，按 Ctrl+Shift+B 编译；
• 检查输出路径是否有 .exe 文件；
• 按 F5 运行，若输出：

Hello, World!

恭喜你，配置成功！