Windows 下配置 C/C++ 开发环境（MSYS2 + GCC + VSCode）

下载 MSYS2#

前往 MSYS2 官网 下载最新版的安装程序 msys2-x86_64-*.exe。

安装 MSYS2#

运行下载好的安装程序，建议安装到默认路径 C:\msys64。

安装完成后，MSYS2 会在开始菜单中创建以下几个终端快捷方式：

验证安装#

打开 MSYS2 UCRT64 终端，输入以下命令检查 pacman 包管理器是否正常工作：

1
pacman --version

如果看到版本信息，说明 MSYS2 安装成功。

更新包数据库#

在 UCRT64 终端中，先更新包数据库：

1
pacman -Syu

这一步可能需要运行多次，如果提示关闭终端，请关闭后重新打开 UCRT64 终端，再次运行 pacman -Syu 直到提示「没有可用的更新」。

安装 GCC#

1
pacman -S --noconfirm mingw-w64-ucrt-x86_64-gcc

这条命令会安装：

• gcc：C 语言编译器
• g++：C++ 编译器
• gdb：调试器
• 以及相关的头文件、库文件和构建工具

验证 GCC#

安装完成后，在 UCRT64 终端中验证：

1
gcc --version
2
g++ --version
3
gdb --version

如果都能正确显示版本信息，说明 GCC 工具链安装成功。

打开系统环境变量设置#

方法一：通过搜索

在 Windows 搜索框中输入「环境变量」，点击搜索结果中的「编辑系统环境变量」：

在弹出的「系统属性」窗口中，点击右下角的「环境变量(N)…」按钮：

点击「环境变量(N)…」后会弹出「环境变量」窗口，上半部分是用户变量（只对当前用户生效），下半部分是系统变量（对所有用户生效）：

方法二：通过设置

右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。

添加 PATH 变量#

在「系统变量」区域找到 Path 变量，选中后点击「编辑」：

添加 MSYS2 工具链路径#

在编辑窗口中，点击「新建」，依次添加以下两个路径：

1
C:\msys64\ucrt64\bin
2
C:\msys64\usr\bin

• C:\msys64\ucrt64\bin：GCC 编译器和相关工具所在目录
• C:\msys64\usr\bin：MSYS2 核心工具（如 bash、make、pacman 等）所在目录

添加完成后，使用「上移」按钮将这两个路径调整到合适的位置，确保它们不会被其他同名命令覆盖。

生效环境变量#

点击「确定」关闭所有窗口后，重新打开一个 cmd 或 PowerShell 窗口，输入：

1
gcc --version

如果显示 GCC 版本信息，说明环境变量配置成功！现在你可以在任意终端中使用 GCC 了。

下载 VSCode#

前往 VSCode 官网 下载安装程序 VSCodeUserSetup-x64-*.exe。

安装 VSCode#

运行安装程序，建议勾选以下选项：

• 「将 “通过 Code 打开” 操作添加到 Windows 资源管理器文件上下文菜单」
• 「将 “通过 Code 打开” 操作添加到 Windows 资源管理器目录上下文菜单」
• 「将 Code 注册为受支持的文件类型的编辑器」
• 「添加到 PATH」（很重要，这样可以在终端中直接输入 code . 打开 VSCode）

安装 C/C++ 扩展#

打开 VSCode，点击左侧活动栏的「扩展」图标（或按 Ctrl+Shift+X），搜索并安装以下扩展：

创建测试项目#

在任意目录下创建一个文件 hello.cpp：

1
#include <iostream>
2

3
int main() {
4
    std::cout << "Hello, C/C++ World!" << std::endl;
5
    return 0;
6
}

命令行编译运行#

打开 cmd 或 PowerShell，进入文件所在目录，执行：

1
g++ hello.cpp -o hello.exe
2
.\hello.exe

如果输出 Hello, C/C++ World!，说明环境配置完全正确！

在 VSCode 中使用#

在文件所在目录打开 VSCode：

1
code .

在 VSCode 中打开 hello.cpp，按 Ctrl+Shift+B 选择 g++.exe build active file，然后按 F5 运行调试，应该能正常编译和运行。