2. 开发环境搭建与工程创建
RT-Thread 的量产项目开发，第一步不是写业务代码，而是把工具链、工程模板、编译下载和串口调试这条链路彻底打通。很多初学者卡在“环境装好了却编译不过”“程序下载了但串口没输出”，本质是对 RT-Thread 提供的三套开发路径（RT-Thread Studio、Env + Keil/IAR、纯命令行 SCons）各自适用的场景和配置边界不清楚。本章围绕这三条路径，讲清原理、流程、实操与常见误区。
一、核心原理：三套工具链的分工
RT-Thread 的工程构建体系以 SCons + Kconfig 为内核：Kconfig 负责图形化配置（选择 BSP、外设、软件包），SCons 负责根据配置生成编译脚本。RT-Thread Studio 是官方 IDE，把这两者封装成图形界面，并内置 GCC 工具链；Env 是独立的命令行/图形配置工具，配合 Keil、IAR 或 GCC 使用；Keil/IAR 则负责最终的编译、下载与调试。理解这条“配置—生成—编译—下载—调试”的链路，是避免环境问题的关键。
二、方法流程：从零创建第一个工程
以最通用的 Env + Keil 路径为例，完整流程如下：
- 安装 Env 工具，并确保 Python、SCons、Git 已随 Env 一起配置好环境变量。
- 下载对应 BSP，例如
rt-thread/bsp/stm32/stm32f407-atk-explorer。 - 在 BSP 目录下右键打开 Env，执行
menuconfig进入图形配置。 - 配置串口、时钟、外设驱动，按需勾选 FinSH 组件与软件包。
- 执行
scons --target=mdk5生成 Keil 工程文件。 - 用 Keil 打开工程，编译、下载，再用串口助手查看输出。
# 进入 BSP 目录后
menuconfig # 图形化配置
scons --target=mdk5 # 生成 Keil MDK5 工程
scons -j8 # 命令行直接编译（GCC）
scons --dist # 导出独立工程包若使用 RT-Thread Studio，可直接“新建 RT-Thread 项目”，选择芯片型号与 BSP，IDE 会自动完成 Kconfig 与 SCons 的封装，无需手动执行命令。
三、案例场景：串口无输出的排查
假设工程编译下载成功，但串口助手没有任何打印。按以下顺序排查：
- 硬件层：确认 USB 转串口线接的是 MCU 的 UART 引脚，而非调试口；共地是否连接。
- 参数层：波特率是否为 115200，数据位 8、停止位 1、无校验。
- 配置层：menuconfig 中是否使能了
RT_USING_CONSOLE与对应 UART 驱动。 - 代码层：
rt_console_set_device("uart1")是否指向正确设备。 - 启动层：是否卡在
rt_hw_board_init或时钟初始化。
进入 msh 后，可用以下命令快速验证系统状态：
msh /> list_device
device type ref count
uart1 Character 3 0
pin Pin 0 0
msh /> ps
thread pri status stack max
main 10 ready 1024 512
msh /> free
total memory: 65536
used memory : 8192四、误区与复盘
| 常见误区 | 现象 | 正确做法 |
|---|---|---|
| 直接改 BSP 源码 | 升级后配置丢失 | 用 menuconfig 配置，保留 .config |
| 忽略工具链版本 | 编译报错或运行异常 | 按 BSP 文档指定 GCC/ARMCC 版本 |
| 串口引脚复用冲突 | 无输出或乱码 | 检查 CubeMX 引脚与驱动一致 |
| 未使能 FinSH | 无 msh 命令行 | 勾选 RT_USING_FINSH 与 FINSH_USING_MSH |
| 下载后未复位 | 程序不运行 | 勾选“下载后复位运行” |
量产项目建议固定工具链版本与 BSP 版本，并将
.config、rtconfig.h 纳入版本管理，避免“换台电脑就编译不过”。环境搭建的本质，是把“配置—构建—编译—下载—调试”这条链路变成可重复、可复现的工程能力。掌握 Env 与 SCons 的配合方式后，无论切换到 Keil、IAR 还是 GCC，都能快速定位问题所在，为后续驱动开发与量产调试打下稳定基础。