3. 开发环境与工具链

RT-Thread 的开发体验由一套相互配合的工具链支撑：图形化的 RT-Thread Studio 负责工程创建、编辑、编译与调试；Env 工具提供命令行配置与构建环境；scons 是底层构建引擎；menuconfig 是 Kconfig 配置系统的交互入口；软件包管理则通过 pkgs 机制把第三方组件引入工程。理解它们之间的分工与协作，是后续所有组件与中间件开发的基础。

一、核心原理：五件工具的分工与协作

这五者并非并列关系，而是有明确的层次。RT-Thread Studio 是集成外壳，内部调用 Env 与 scons；Env 是命令行工具集，封装了 Python、scons、menuconfig 等；scons 读取 SConscript 脚本完成源码收集与编译；menuconfig 读取 Kconfig 文件生成 .config 配置；软件包管理则依据配置从在线仓库拉取包并生成 pkgs 目录。它们共同围绕一个核心文件——rtconfig.h，把配置转化为编译期宏。

二、方法流程：从创建工程到烧录运行

以 RT-Thread Studio 为例，典型流程如下：

1. 创建工程：选择“文件 → 新建 → RT-Thread 项目”，指定芯片型号（如 STM32F407）与 RT-Thread 版本，Studio 自动生成工程骨架与 rtconfig.h。
2. 配置系统：双击工程中的 RT-Thread Settings，或右键选择“配置”，打开图形化 menuconfig，勾选内核、组件与软件包。
3. 保存配置：保存后 Studio 自动执行 scons 的配置阶段，更新 rtconfig.h 与 packages 目录。
4. 编译工程：点击“构建”按钮，Studio 调用 scons 编译，输出 rtthread.elf 等文件。
5. 烧录调试：配置调试器（ST-Link/J-Link），点击“下载”烧录，再点击“调试”进入断点调试。

若使用 Env 命令行，流程等价但更灵活：

# 进入 BSP 目录
cd rt-thread/bsp/stm32/stm32f407-atk-explorer

# 打开配置菜单
menuconfig

# 更新软件包（拉取 pkgs）
pkgs --update

# 编译工程
scons

# 清理编译产物
scons -c

三、关键配置与软件包管理

menuconfig 的配置结果最终写入 .config，再由 scons 转换为 rtconfig.h。软件包管理依赖 pkgs --update 从 packages 目录的索引中拉取源码，并在 rtconfig.h 中定义 PKG_USING_xxx 宏。下表列出常用命令与作用：

四、案例场景：为工程添加 cJSON 软件包

假设需要在 STM32F407 工程中解析 JSON 数据。操作步骤如下：

1. 在 Studio 中打开 RT-Thread Settings，进入“软件包 → JSON → cJSON”。
2. 勾选 cJSON，选择版本（如 latest），保存配置。
3. 在终端执行 pkgs --update，Env 会从仓库下载 cJSON 源码到 packages/cJSON-latest。
4. 在代码中包含头文件并调用：

#include <cJSON.h>

void json_demo(void)
{
    cJSON *root = cJSON_CreateObject();
    cJSON_AddStringToObject(root, "name", "rt-thread");
    cJSON_AddNumberToObject(root, "ver", 5.0);
    char *out = cJSON_Print(root);
    rt_kprintf("json: %s\n", out);
    cJSON_Delete(root);
    cJSON_free(out);
}

编译后若出现 undefined reference to cJSON_CreateObject，通常是因为未执行 pkgs --update，或 rtconfig.h 中未定义 PKG_USING_CJSON。此时重新保存配置并更新包即可。

五、误区与复盘

• 误区一：只改 .config 不重新生成 rtconfig.h。手工编辑 .config 后必须执行 scons --useconfig=.config 或通过 menuconfig 保存，否则编译仍用旧宏。
• 误区二：忘记 pkgs --update。menuconfig 中勾选软件包只是写入配置，源码并未下载，必须执行更新命令。
• 误区三：Studio 与 Env 配置不同步。两者操作的是同一份 .config 与 rtconfig.h，若在 Studio 外修改，需在 Studio 中刷新工程或重新加载配置。
• 误区四：scons 报错就删工程。多数构建错误源于路径含中文、Python 版本不匹配或 SConscript 缺失，应先看日志定位，而非重建。