VS Code 配置 C/C++ 开发环境 (MinGW-w64) 终极指南

Visual Studio Code (VS Code) 凭借其轻量、强大和高度可扩展的特性，已成为许多开发者的首选代码编辑器。本文将一步步带你从零开始，在 Windows 系统上使用 VS Code 和 MinGW-w64 工具链，搭建一个完整、高效的 C/C++ 开发与调试环境。

准备工作

在开始之前，请确保你已经完成了以下准备：

安装 Visual Studio Code: 如果你还没有安装，请前往 VS Code 官网下载并安装。
一个稳定的网络连接: 我们需要下载一些工具和插件。

第一步：安装 MinGW-w64 编译器

MinGW-w64 是一个在 Windows 上提供原生 GCC 工具链（包括 C/C++ 编译器 gcc 和 g++）的项目。我们提供两种安装方式，你可以根据自己的偏好选择其一。

方式一：使用 MSYS2 安装 (推荐)

这种方式的好处是可以通过包管理器 pacman 方便地更新和管理工具链。

下载 MSYS2: 访问 MSYS2 官网，下载并运行最新的安装程序。按照默认设置一路“下一步”即可。
更新 MSYS2 包数据库: 安装完成后，从开始菜单找到并打开 “MSYS2 UCRT64” 终端。执行以下命令更新包数据库和基础包（如果提示关闭窗口，请照做，然后重新打开终端继续执行）。
1
2
pacman -Syu
pacman -Su
安装 MinGW-w64 工具链: 在同一个终端中，执行以下命令来安装完整的 C/C++ 编译器工具链。
1
pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain
安装过程中会提示确认，按回车键默认全部安装即可。

方式二：下载二进制包 (更直接)

这种方式无需安装额外的管理器，下载解压即可，非常纯粹。

Ⅰ. 我们推荐使用 WinLibs 提供的编译好的包。

下载 WinLibs: 访问 WinLibs 官网的下载页面。
找到最新的 GCC + GDB 版本，选择 UCRT runtime 的 Win64 版本进行下载（通常是一个 .zip 压缩包）。
解压文件: 下载完成后，将压缩包解压到一个没有中文和空格的稳定路径。强烈推荐直接解压到 C: 盘根目录，这样解压后的文件夹路径就是 C:\mingw64。

Ⅱ. Github 开源的二进制包

下载二进制包: 访问 Github 。
找到Releases：Releases 页面。
在Releases中找到最新的版本的Assets，选择 X86-64 的 posix-seh-ucrt-rt 版本进行下载（通常是一个 .7z 压缩包）。
解压文件: 下载完成后，将压缩包解压到一个没有中文和空格的稳定路径。

第二步：配置系统环境变量

为了让 VS Code 和系统能够找到 gcc, g++, gdb 等命令，我们需要将编译器的路径添加到系统的 PATH 环境变量中。

找到编译器路径: 根据你选择的安装方式，路径会有所不同。
- 方式一 (MSYS2): 路径通常为 C:\msys64\ucrt64\bin 和 C:\msys64\usr\bins
- 方式二 (二进制包): 路径为你解压的路径下的 bin 文件夹，例如 C:\mingw64\bin
添加到环境变量:
- 在 Windows 搜索栏中搜索“编辑系统环境变量”并打开。
- 点击“环境变量…”。
- 在“系统变量”区域找到并双击 Path。
- 点击“新建”，然后将你上面找到的对应路径粘贴进去。
- 一路点击“确定”保存所有窗口。
验证安装: 打开一个新的 CMD 或 PowerShell 窗口（注意是新的！），分别输入以下命令：
1
2
3
gcc --version
g++ --version
gdb --version
如果三个命令都能正确显示版本号，说明你的编译器和环境变量已经配置成功！

第三步：安装 VS Code 插件

打开 VS Code，点击左侧的扩展图标，搜索并安装由 Microsoft 官方提供的 C/C++ Extension Pack。它包含了 C/C++ 智能提示、调试等核心功能。

第四步：创建并配置你的第一个项目

现在，让我们来创建一个 “Hello, World!” 项目来验证所有配置。

创建项目文件夹: 在你喜欢的位置创建一个新文件夹，例如 HelloWorld，然后在 VS Code 中打开这个文件夹。

创建源文件: 在 HelloWorld 文件夹中新建一个文件，命名为 main.cpp，并输入以下代码：

#include <iostream>
#include <vector>
#include <string>

int main()
{
    std::vector<std::string> msg {"Hello", "C++", "World", "from", "VS Code", "and", "MinGW-w64!"};

    for (const std::string& word : msg)
    {
        std::cout << word << " ";
    }
    std::cout << std::endl;

    return 0;
}

配置智能提示 (c_cpp_properties.json):
- 按下 Ctrl + Shift + P 打开命令面板，输入 C/C++: Edit Configurations (UI)。
- 在 编译器路径 (Compiler path) 配置项中，VS Code 通常会自动检测到你配置好的 g++.exe。如果未检测到，请手动选择它的完整路径（例如 C:\mingw64\bin\g++.exe 或 C:\msys64\ucrt64\bin\g++.exe）。
- IntelliSense 模式 会自动选择 windows-gcc-x64。
- 保存后，VS Code 会自动在项目下创建 .vscode/c_cpp_properties.json 文件。
配置编译任务 (tasks.json):
- 按下 Ctrl + Shift + P，输入 Tasks: Configure Default Build Task。
- 在弹出的选项中选择 C/C++: g++.exe build active file。
- VS Code 会自动创建 .vscode/tasks.json 文件。这个文件定义了如何调用 g++ 编译器来编译你的代码。
配置调试器 (launch.json):
- 切换到“运行和调试”侧边栏（Ctrl + Shift + D）。
- 点击“创建 launch.json 文件”，在弹出的环境中选择 C++ (GDB/LLDB)。
- 接着选择 g++.exe - 生成和调试活动文件。
- VS Code 会自动创建 .vscode/launch.json 文件。它告诉调试器如何启动你的程序，并自动关联了上一步创建的编译任务。

第五步：编译、运行和调试

所有配置都已完成！现在来享受成果吧。

编译: 打开 main.cpp 文件，按下 Ctrl + Shift + B 来执行默认的编译任务。如果一切顺利，终端会显示编译成功，并且在文件浏览器中会看到一个 main.exe 文件。
运行和调试:
- 在 main.cpp 文件的 std::cout << word << " "; 这一行左侧点击，设置一个红点断点。
- 按下 F5 键启动调试。
- 代码会在你设置的断点处暂停。此时你可以查看左侧的变量值、调用堆栈，并使用调试控制栏（F10 单步跳过，F11 单步进入）来逐行执行代码。

总结

恭喜你！你已经成功搭建了一个功能完善的 C/C++ 开发环境。通过这套配置，你不仅可以编写和编译代码，还能利用 VS Code 强大的调试功能来分析和解决问题，极大地提升了开发效率。现在，开始你的 C++ 编程之旅吧！

lczhuigz's Blog