VSCode + RT-Thread + ST-Link + GD32 编译环境搭建与下载调试指南

1. 引言

在嵌入式开发中，使用 Keil MDK 或 IAR 等商业 IDE 是常见选择，但它们存在授权费用高、跨平台支持差、编辑器体验不如 VSCode 等问题。本文将详细介绍如何使用 VSCode 作为主力 IDE，配合 RT-Thread Studio 的构建工具链，通过 ST-Link 调试器对 GD32 系列微控制器进行编译、下载和在线调试。这套方案完全免费，且能充分利用 VSCode 丰富的插件生态。

2. 准备工作

在开始搭建环境前，需要准备好以下硬件和软件。

2.1 硬件清单

• 开发板：基于 GD32F103 / GD32F450 等任意 GD32 系列 MCU 的开发板。
• 调试器：ST-Link V2 或 V3（注意：部分山寨 ST-Link 可能需要驱动修复）。
• 连接线：杜邦线或 SWD 排线，用于连接 ST-Link 与开发板的 SWDIO、SWCLK、GND 引脚。
• USB 数据线：用于给开发板供电以及连接 ST-Link 到电脑。

2.2 软件清单

3. 安装与配置核心工具

3.1 安装 VSCode 及必要插件

1. 从 code.visualstudio.com 下载并安装 VSCode。
2. 安装以下关键插件：
   • C/C++ (ms-vscode.cpptools)：提供代码补全、跳转、调试支持。
   • Cortex-Debug (marus25.cortex-debug)：用于 ARM Cortex-M 内核的调试。
   • RT-Thread Project Assistant (RT-Thread.rt-thread-project-assistant)：提供 RT-Thread 项目创建、配置、编译等一站式辅助功能，可直接在 VSCode 中完成工程初始化，无需切换到 RT-Thread Studio。
   • GitLens (可选)：增强 Git 功能。

3.2 安装RT-Thread Studio

教程很多自行安装

3.3 安装 PyOCD

从RT-Thread Studio SDK里安装,选低版本安装 ，stm32芯片忽略

3.4 安装 ST-Link 驱动

从RT-Thread Studio SDK里安装 1.6版本

4.1 使用 RT-Thread Studio 创建基础工程（可选）

虽然我们最终用 VSCode 开发，但 RT-Thread Studio 可以快速生成带有完整 BSP（板级支持包）和构建配置的工程。

1. 打开 RT-Thread Studio，点击 文件 -> 新建 -> RT-Thread 项目。
2. 选择 基于芯片，搜索 GD32F103 或你的具体型号。
3. 填写项目名称，点击完成。Studio 会自动下载工具链并生成工程。
4. 可正常编译通过,GD可以找别人已经创建完成的工程修改，可看网上教程。

5. 配置 VSCode 编译与下载任务

5.1 配置编译、下载、调试

安装完RT-Thread Project Assistant
插件后，打开vscode 左下方会有个导入

点击导入，填写rt-threadstudio路径后，会自动搜索相应路径下的编译器和工具
gd32使用st-link 下载和调试工具建议选，否则只能下载，不能调试，其他本部的pyocd也是类似的情况，会出现调试失败

芯片名称，选可以平替的STM32芯片名称,如gd32F103 ->stm32F103,我这边是GD32F470,选STM32F429 可以正常使用。
最后点击生成，就可以生成相应的配置

6. 编译与下载调试实战

6.1 编译项目

生成后点击构建，就能正常编译，有报错，自己按照错误进行处理

6.2 连接硬件

1. 将 ST-Link 通过 SWD 接口连接到 GD32 开发板：
   • ST-Link SWDIO → GD32 SWDIO (PA13)
   • ST-Link SWCLK → GD32 SWCLK (PA14)
   • ST-Link GND → GD32 GND
   • ST-Link 3.3V → GD32 3.3V (可选，用于给目标板供电)
2. 将 ST-Link 插入电脑 USB 口。
3. 确认设备管理器中出现 ST-Link 设备。

6.3 下载与调试

下载可以点击对应的下载按钮，即可下载

如果不能下载，先使用rt-thread studio 先测试，能正常下载后再使用vscode

调试，可正常点击调试按键，依次调试，遇到问题先在rt-thread studio 测试后再使用vscode
![在这里插入图片描述](https://i-blog.csdnimg.cn/direct/00848545a813494b8eb7c78e8fbb00ac.png

7. 总结

通过以上步骤，我们成功搭建了一套基于 VSCode + RT-Thread + ST-Link + GD32 的完整嵌入式开发环境。这套方案的优势在于：

• 完全免费：无需购买 Keil 或 IAR 授权。
• 编辑器体验优秀：VSCode 的智能提示、代码导航、Git 集成远超传统 IDE。
• 调试功能强大：Cortex-Debug + PyOCD 支持断点、变量监视、外设寄存器查看等完整调试功能。
• 易于扩展：可以轻松集成代码格式化、静态检查、单元测试等工具链。

现在，你可以打开 VSCode，按下 F5 体验一键编译下载调试的流畅开发流程了。