909 字
5 分钟
在Windows上使用MSYS2+MinGW工具链 | gcc | gdb | cmake | make | Ninja | VScode
通过在Windows系统上安装MSYS2模拟Linux环境,并使用pacman包管理器安装MinGW版的gcc、gdb、cmake、make工具链,并使用VScode搭建有关C/Cpp、嵌入式Stm32的开发环境。

相关链接#

MSYS2+VScode安装与配置#

前往MSYS2官方文档VScode官网下载安装包,并进行安装(推荐安装路径均为默认)。

VScode常用插件(拓展)与设置#

建议登录一个Microsoft微软或GitHub账户,用于开启同步设置,并在默认配置文件新建配置文件中进行常用设置,后面根据语言可以新建配置文件复制通用配置,再安装对应的拓展,进行拓展分离。

VScode设置(settings.json)文件内容:

{
// 自动保存文件
"files.autoSave": "afterDelay",
// 自动猜测文件编码
"files.autoGuessEncoding": true,
// 列表、光标移动、编辑器、光标闪烁样式平滑
"workbench.list.smoothScrolling": true,
"editor.cursorSmoothCaretAnimation": "on",
"editor.smoothScrolling": true,
"editor.cursorBlinking": "smooth",
// 按住 Ctrl 滚轮缩放编辑器字体
"editor.mouseWheelZoom": true,
// 粘贴、输入、保存时自动格式化
"editor.formatOnPaste": true,
"editor.formatOnType": true,
"editor.formatOnSave": true,
// 自动换行(避免横向滚动条)
"editor.wordWrap": "on",
// 括号配对引导线
"editor.guides.bracketPairs": true,
// 允许代码片段触发快速建议
"editor.suggest.snippetsPreventQuickSuggestions": false,
// 回车键智能接受建议(仅当没有其他文本建议时)
"editor.acceptSuggestionOnEnter": "smart",
// 建议列表优先显示最近使用的项
"editor.suggestSelection": "recentlyUsed",
// 使用自定义对话框样式
"window.dialogStyle": "custom",
// 在概览标尺中显示断点
"debug.showBreakpointsInOverviewRuler": true,
}

打开VScode设置(Ctrl+,)后,点击打开json文件,即可粘贴设置;下面是一些常用拓展:

  1. Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code:简中语言包。
  2. Hex Editor:16进制文件查看编辑器。
  3. Error Lens:报错高亮。
  4. GBK to UTF8 for vscode:编码格式快速转换。
  5. Doxygen Documentation Generator:注释生成器。
  6. Hungry Delete:快速删除空行、缩进。
  7. Image preview:图片预览器。
  8. Material Icon Theme:文件Icon主题美化。
  9. One Dark Pro:VScode编辑器主题美化。
  10. Path Intellisense:路径补全。
  11. Prettier - Code formatter:代码格式自动优化。
  12. Remote - SSH:SSH链接远程项目地址,似本地一般的编辑体验。
  13. WakaTime:代码编辑时间统计,需要登录。

MSYS2集成终端#

MSYS2文档中,提供了将MSYS2终端集成到VScode的方法,便是在settings.json文件中添加如下字段:

// 注意最外层大括号已在settings.json中存在
// 注意该配置的路径为默认安装路径
{
"terminal.integrated.profiles.windows": {
"MSYS2 UCRT": {
"path": "cmd.exe",
"args": [
"/c",
"C:\\msys64\\msys2_shell.cmd -defterm -here -no-start -ucrt64"
]
}
}
}

随后便可在VScode中打开MSYS2终端, 除此之外也可以在Windows搜索中输入ucrt打开终端:

C/C++环境配置#

打开MSYS2的UCRT64终端,输入如下命令安装工具链:

Terminal window
# 编译器、调试器、构建系统、构建工具
pacman -S mingw-w64-ucrt-x86_64-{gcc,gdb,cmake,ninja,make}
# 版本检查
gcc -v
gdb -v
cmake --version
ninja --version
mingw32-make --version

打开VSCODE,创建配置文件,复制继承上文中的通用配置,随后激活后,在拓展中安装:

由于上文已经安装了MinGW工具链,因此拓展会自动寻找环境变量中的gcc编译器,MSYS2安装在默认位置下便无需手动配置路径了。

Stm32环境配置#

安装Stm32CubeMX用于下载固件库和创建工程。

打开MSYS2的UCRT64终端,输入如下命令安装工具链:

Terminal window
# 交叉编译器
pacman -S mingw-w64-ucrt-x86_64-arm-none-eabi-gcc
# 版本检查
arm-none-eabi-gcc --version

打开VSCODE,创建配置文件,复制继承上文中的通用配置,随后激活后,在拓展中安装:

STM32CubeIDE-for-Visual-Studio-Code

同样的,我们已在前文中配置好了gcc、cmake等工具链,拓展在安装完必要的组件后,会自行查找所需工具路径,现在点击左侧小蝴蝶,就能用上Stm32CubeIDE的功能了。

这篇文章是否对你有帮助?

发现错误或想要改进这篇文章?

文章修订历史 (5 次)

查看变更记录
2026-05-10 856a622

CMS:Update Posts “msys”

2026-05-10 fb8ed18

CMS:Update Posts “msys”

2026-05-10 579a7ed

CMS:Update Posts “msys”

2026-05-10 66cdca3

CMS:Update Posts “msys”

2026-05-10 5f4cfdf

CMS: New Posts "msys"

在Windows上使用MSYS2+MinGW工具链 | gcc | gdb | cmake | make | Ninja | VScode
https://blog.srprolin.top/posts/msys/
作者
RoL1n
发布于
2026-05-10
许可协议
CC BY-NC-SA 4.0

目录
  1. 1
    相关链接
  2. 2
    MSYS2+VScode安装与配置
  3. 3
    C/C++环境配置
  4. 4
    Stm32环境配置