从零开始配置 VSCode 运行 C++ 的详细权威指南（Windows 系统）

最新推荐文章于 2026-05-07 05:58:01 发布

原创最新推荐文章于 2026-05-07 05:58:01 发布 · 1.5k 阅读

13 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#vscode #c++ #windows

第一步：安装 Visual Studio Code

访问官网 https://code.visualstudio.com/
下载 Windows 版安装包（.exe 文件）
双击安装，勾选以下选项：
- 添加到 PATH（重要！）
- 所有其他选项默认勾选

第二步：安装 C++ 编译器（MinGW）

🔧 MinGW 是 Windows 下的 C++ 编译环境

下载 MinGW：
- 访问 https://sourceforge.net/projects/mingw/
- 点击 Download 下载 mingw-get-setup.exe
安装 MinGW：
- 运行安装程序，安装目录设为 C:\MinGW（避免中文路径）
- 勾选 Add MinGW to the system PATH → 点击 Continue
安装编译器组件：
- 在安装管理器中勾选：
  - mingw32-base
  - mingw32-gcc-g++（关键！）
  - mingw32-gdb
- 点击菜单栏 Installation → Apply Changes
- 等待安装完成（约 5-10 分钟）
验证安装：
- 打开命令提示符（Win+R 输入 cmd）
- 输入命令：
```
g++ --version
```
  ✅ 成功显示版本号（如 g++ (MinGW.org) 9.2.0）

第三步：配置环境变量

⚠️ 如果上一步验证失败，手动配置：

右键“此电脑” → 属性 → 高级系统设置 → 环境变量
在 系统变量 中找到 Path → 编辑 → 新建
添加 MinGW 的 bin 目录路径：
```
C:\MinGW\bin
```
保存所有窗口，重启电脑生效。

第四步：安装 VSCode C++ 扩展

打开 VSCode
点击左侧扩展图标（或按 Ctrl+Shift+X）
搜索并安装以下扩展：
- C/C++（Microsoft 官方扩展）
- Code Runner（一键运行代码）

第五步：创建并运行第一个 C++ 程序

新建文件夹（例如 D:\CppProjects）
在 VSCode 中打开文件夹：
- 文件 → 打开文件夹 → 选择 D:\CppProjects
新建 C++ 文件：
- 点击新建文件图标 → 命名为 hello.cpp

输入测试代码：

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

保存文件（Ctrl+S）

第六步：配置编译设置（关键！）

在项目文件夹中新建 .vscode 子文件夹

在 .vscode 内新建两个文件：

tasks.json（编译配置）

{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "cppbuild",
      "label": "C/C++: g++.exe 生成活动文件",
      "command": "g++",
      "args": [
        "-fdiagnostics-color=always",
        "-g",
        "${file}",
        "-o",
        "${fileDirname}\\${fileBasenameNoExtension}.exe"
      ],
      "options": {
        "cwd": "${fileDirname}"
      },
      "problemMatcher": ["$gcc"],
      "group": "build"
    }
  ]
}

launch.json（调试配置）

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "g++.exe - 生成和调试活动文件",
      "type": "cppdbg",
      "request": "launch",
      "program": "${fileDirname}\\${fileBasenameNoExtension}.exe",
      "args": [],
      "stopAtEntry": false,
      "cwd": "${fileDirname}",
      "environment": [],
      "externalConsole": true, // 重要！确保在外部控制台显示
      "MIMode": "gdb",
      "miDebuggerPath": "gdb.exe",
      "setupCommands": [
        {
          "description": "为 gdb 启用整齐打印",
          "text": "-enable-pretty-printing",
          "ignoreFailures": true
        }
      ],
      "preLaunchTask": "C/C++: g++.exe 生成活动文件"
    }
  ]
}

第七步：运行程序（三种方法）

方法1：使用 Code Runner（最简单）

在 hello.cpp 文件中右键 → Run Code
输出结果在底部终端显示

方法2：手动编译运行

打开 VSCode 终端（Ctrl+ ）
输入命令：
```
g++ hello.cpp -o hello.exe
.\hello.exe
```

方法3：调试运行（推荐）

打开 hello.cpp
按 F5 → 选择 C++ (GDB/LLDB)
自动编译并弹出控制台显示结果

常见问题解决

终端闪退：
- 在 launch.json 中设置 "externalConsole": true
编译命令找不到：
- 重启 VSCode 或电脑，确保环境变量生效

中文乱码：

在 tasks.json 的 args 中添加：

"-fexec-charset=GBK", // Windows 默认编码

验证成功

输出结果应显示：
```
Hello World!
```
至此你已拥有完整的 C++ 开发环境！

💡 提示：每次新建项目时，只需复制 .vscode 文件夹到项目目录即可复用配置。