☰
Msys2 + VSCode 配置 Windows 下的 C/C++ 开发环境
2026/9/26 9:21:14 网站建设 项目流程

1. 引言

在 Windows 上进行 C/C++ 开发,很多初学者会直接使用 Visual Studio,但它的体积庞大、启动缓慢,而且对于轻量级项目或算法竞赛来说显得过于笨重。而Msys2 + VSCode的组合,凭借其轻量、灵活、可定制性强的特点,正成为越来越多开发者的首选。

Msys2 提供了一个类 Unix 的软件包管理环境,可以方便地安装 GCC、GDB、Make 等工具链;而 VSCode 则是一款轻量但功能强大的代码编辑器。两者结合,你可以在 Windows 上获得接近 Linux 的原生开发体验。

本文将手把手带你从零开始,完成 Msys2 的安装、工具链配置、VSCode 环境搭建,并最终成功运行你的第一个 C/C++ 程序。

2. 准备工作

在开始之前,请确保你的电脑满足以下条件:

  • 操作系统:Windows 10 或 Windows 11(64 位)
  • 网络环境:能够正常访问互联网,因为需要下载安装包和更新软件源
  • 磁盘空间:至少预留 2GB 可用空间(Msys2 基础安装约 500MB,加上工具链和依赖会更多)

3. 安装 Msys2

3.1 下载与安装

  1. 打开浏览器,访问 Msys2 官方网站:https://www.msys2.org/
  2. 在页面中找到下载链接,选择msys2-x86_64-*.exe安装包下载。
  3. 双击运行安装程序,建议安装到默认路径C:\msys64,也可以自定义路径,但路径中不要包含中文或空格,否则后续可能出现兼容性问题。
  4. 安装完成后,勾选「Run MSYS2 now」启动 MSYS2 终端。

3.2 更新软件包

首次启动后,需要更新软件包数据库和核心组件。在 MSYS2 终端中依次执行以下命令:

pacman-Sy

然后更新所有已安装的软件包:

pacman-Su

提示:如果提示需要关闭终端才能完成更新,请关闭所有 MSYS2 窗口后重新打开,再执行一次pacman -Su确认更新完成。

4. 安装 C/C++ 工具链

4.1 安装 GCC 编译器

在 MSYS2 终端中执行以下命令,安装 GCC 编译器、GDB 调试器和 Make 构建工具:

pacman-Smingw-w64-x86_64-gcc mingw-w64-x86_64-gdb mingw-w64-x86_64-make

这里使用的是MinGW-w64版本的 GCC,它编译出的程序可以直接在 Windows 上运行,不依赖 MSYS2 环境。

4.2 安装 CMake(可选)

如果你打算使用 CMake 来管理项目,可以一并安装:

pacman-Smingw-w64-x86_64-cmake mingw-w64-x86_64-ninja

4.3 验证安装

安装完成后,在 MSYS2 终端中验证编译器是否正常工作:

gcc--version

如果能看到类似gcc (GCC) 13.x.x的版本信息,说明 GCC 安装成功。

5. 配置环境变量

为了让 VSCode 的终端和系统命令行也能直接使用gcc、g++、gdb等命令,需要将 MinGW-w64 的bin目录添加到系统环境变量中。

  1. 打开「此电脑」→ 右键 →「属性」→「高级系统设置」→「环境变量」。
  2. 在「系统变量」中找到Path,点击「编辑」。
  3. 点击「新建」,添加以下路径(如果你的 Msys2 安装在其他位置,请对应修改):
C:\msys64\mingw64\bin
  1. 点击「确定」保存,然后重新打开所有终端窗口(包括 VSCode),使环境变量生效。

验证方式:在 CMD 或 PowerShell 中输入:

gcc--version

如果同样能显示版本信息,说明环境变量配置成功。

6. 安装与配置 VSCode

6.1 安装 VSCode

如果你还没有安装 VSCode,请前往官网https://code.visualstudio.com/下载并安装。安装时建议勾选「添加到 PATH」和「在右键菜单中打开」等选项,方便后续使用。

6.2 安装必要插件

打开 VSCode,进入扩展市场(Ctrl+Shift+X),搜索并安装以下插件:

  • C/C++(作者:Microsoft):提供代码补全、调试、语法高亮等核心功能
  • C/C++ Extension Pack(可选):包含一系列 C/C++ 相关扩展
  • Code Runner(可选):一键运行代码,适合快速测试

6.3 配置 C/C++ 插件

  1. 按下Ctrl+Shift+P打开命令面板,输入C/C++: Edit Configurations (UI)并回车。
  2. 在弹出的配置界面中,将「编译器路径」设置为:
C:\msys64\mingw64\bin\gcc.exe
  1. 「IntelliSense 模式」选择gcc-x64。
  2. 保存配置,VSCode 会自动生成.vscode/c_cpp_properties.json文件。

7. 创建第一个 C/C++ 项目

7.1 新建项目文件夹

在本地创建一个项目文件夹,例如hello_cpp,然后用 VSCode 打开该文件夹。

7.2 编写代码

在项目根目录下新建文件main.cpp,输入以下代码:

#include<iostream>intmain(){std::cout<<"Hello, Msys2 + VSCode!"<<std::endl;return0;}

7.3 配置构建任务

为了让 VSCode 能够一键编译,我们需要创建一个构建任务:

  1. 按下Ctrl+Shift+P,输入Tasks: Configure Default Build Task并回车。
  2. 选择「C/C++: g++.exe build active file」。
  3. VSCode 会自动生成.vscode/tasks.json文件,内容大致如下:
{"version":"2.0.0","tasks":[{"type":"cppbuild","label":"C/C++: g++.exe build active file","command":"C:\\msys64\\mingw64\\bin\\g++.exe","args":["-fdiagnostics-color=always","-g","${file}","-o","${fileDirname}\\${fileBasenameNoExtension}.exe"],"options":{"cwd":"${fileDirname}"},"problemMatcher":["$gcc"],"group":{"kind":"build","isDefault":true}}]}

7.4 编译运行

  1. 按下Ctrl+Shift+B执行构建任务,VSCode 会在底部终端中调用g++编译当前文件。
  2. 编译成功后,在项目目录下会生成main.exe文件。
  3. 在 VSCode 终端中运行:
.\main.exe

如果输出Hello, Msys2 + VSCode!,恭喜你,环境配置成功!

8. 配置调试功能

8.1 创建调试配置

  1. 在main.cpp中设置断点(点击行号左侧)。
  2. 按下F5,VSCode 会提示选择调试环境,选择「C++ (GDB/LLDB)」。
  3. 选择「g++.exe build and debug active file」,VSCode 会自动生成.vscode/launch.json文件。

8.2 调试配置示例

生成的launch.json大致如下:

{"version":"0.2.0","configurations":[{"name":"C/C++: g++.exe build and debug active file","type":"cppdbg","request":"launch","program":"${fileDirname}\\${fileBasenameNoExtension}.exe","args":[],"stopAtEntry":false,"cwd":"${fileDirname}","environment":[],"externalConsole":false,"MIMode":"gdb","miDebuggerPath":"C:\\msys64\\mingw64\\bin\\gdb.exe","setupCommands":[{"description":"Enable pretty-printing for gdb","text":"-enable-pretty-printing","ignoreFailures":true}],"preLaunchTask":"C/C++: g++.exe build active file"}]}

8.3 开始调试

再次按下F5,程序会在断点处暂停,你可以查看变量值、单步执行、查看调用栈等,体验完整的调试功能。

9. 常见问题与解决

9.1 编译时提示g++: error: ...

  • 检查环境变量是否正确配置,重新打开终端。
  • 确认当前文件路径不包含中文或空格。

9.2 VSCode 找不到编译器

  • 在c_cpp_properties.json中确认编译器路径是否正确。
  • 尝试重启 VSCode 或重新加载窗口(Ctrl+Shift+P→Developer: Reload Window)。

9.3 运行 exe 时闪退

  • 在程序末尾添加std::cin.get();暂停窗口,或使用externalConsole: true让程序在独立窗口中运行。

9.4 更新 Msys2 后工具链失效

  • 重新执行pacman -Su更新,并确认mingw64\bin路径下的gcc.exe仍然存在。

10. 总结

通过本文的配置,你已经成功在 Windows 上搭建了一套轻量、高效的 C/C++ 开发环境:

  • Msys2提供了便捷的软件包管理和类 Unix 终端体验
  • MinGW-w64工具链让你在 Windows 上直接编译出原生可执行文件
  • VSCode提供了现代化的代码编辑、构建和调试体验

这套组合非常适合算法竞赛、嵌入式开发、学习 C/C++ 语法以及轻量级项目开发。后续你还可以通过pacman安装更多库(如 OpenCV、Boost 等),进一步扩展你的开发能力。

现在,开始你的 C/C++ 编程之旅吧!

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询