RT-Thread 串口只输出不响应的排查方法-平芜编程栈

前言

用 RT-Thread Studio 建好工程、写完代码、烧录到板子里，串口助手也打开了——然后发现板子的启动信息能正常打印出来，但自己在串口助手里输的命令一条都不响应。

这是我入坑 RT-Thread 时遇到的第一个拦路虎，排查了一段时间才发现问题出在哪。这篇文章整理了我当时的排查思路和最终的解决方案，希望能帮到同样被这个问题卡住的人。

一、现象

串口能看到板子启动打印Hello RT-Thread!，但是——

发list_device
发version
发help

没有一丝响应。连最基础的msh>提示符也不出来。

接线确认过、波特率是 115200、TX/RX 交叉接了、rtconfig.h里FINSH_USING_MSH也开了——一切看起来都对的，但它就是不干活。

二、排查过程

先排除了最可能的前三项：

✅ 接线正确：TX → 模块 RX，RX → 模块 TX，GND → GND
✅rtconfig.h里有RT_CONSOLE_DEVICE_NAME "uart1"和FINSH_USING_MSH
✅ 串口助手配置正确：115200-8-N-1，勾选了加回车换行

接下来用示波器量 PA10（RX 脚），确实有波形——说明数据已经发到板子上了。那问题肯定出在软件层。

直到我打开了自己的main.c……

三、祸根

int main(void) { MX_GPIO_Init(); MX_USART1_UART_Init();  thread3 = rt_thread_create("thread3", ...); if (thread3 != RT_NULL) rt_thread_startup(thread3);  while(1) ← 空的 { // 啥都没有 } }

就是这个空while(1)—— 在 RTOS 里，它是一只吞掉所有 CPU 的怪兽。

四、为什么空循环会导致 FinSH 无响应？

RT-Thread 是抢占式实时操作系统，优先级数字越小越优先。

关键的两个线程：

线程	优先级	职责
main	10	你的主程序
tshell	20	FinSH 命令处理

优先级对比：10 < 20 → main 优先级更高。

当main()进入while(1)空循环后，调度器的行为如下：

① main 线程进入 while(1)，永远 running ② 调度器检查就绪队列：main 优先级 10，一直 Ready ③ tshell 优先级 20，低于 main，永远拿不到 CPU ④ 串口接收中断虽然收到数据，放进环形缓冲区 ⑤ 但 tshell 线程没被调度，没人去读取和处理缓冲区 ⑥ 你在串口助手里输入的所有命令，全部堆在缓冲区里

命令没有消失，但没人处理。

这就好比快递已经送到小区门口了，但门卫上班时间对着空桌面发愣，就是不取货——因为门卫的座机（tshell）比经理（main）优先级低，经理一直在打私人电话不停线。

五、调度器时间轴：一图看懂

修复前

main (pri=10) ┌───────────────────────────────────────────┐ │ while(1) 空循环 · 永远 running │ └───────────────────────────────────────────┘ tshell (pri=20)┌───────────────────────────────────────────┐ │ 永远在 ready · 拿不到 CPU │ └───────────────────────────────────────────┘

修复后

main (pri=10) ┌─────┐ ┌───────────────────────────────────┐ │ready│ │ sleeping (mdelay 1000) │ └─────┘ └───────────────────────────────────┘ tshell (pri=20)┌──────────────────────────────────┐ ┌──────┐ │ running — 处理串口命令 ✅ │ │ready │ └──────────────────────────────────┘ └──────┘ ↑ 发 list_thread / help 正常响应

六、修法

有两种方案，推荐第二种。

方案 A：加 mdelay 让出 CPU

while(1) { rt_thread_mdelay(1000); // ← 每 1 秒醒一次，然后继续挂起 }

本质：把 main 线程挂起 → 调度器选最高优先级就绪线程 → tshell 拿到 CPU → 处理你输入的命令

方案 B：main 使命完成，直接退出（推荐）

int main(void) { MX_GPIO_Init(); MX_USART1_UART_Init();  thread3 = rt_thread_create("thread3", ...); if (thread3 != RT_NULL) rt_thread_startup(thread3);  return 0; // ← main 线程自动挂起，不再参与调度 }

return 0的本质：main 线程永久挂起（不销毁，只是不再参与调度），调度器长期把 CPU 给其他线程。

七、用 list_thread 验证修复效果

修复后在串口助手里输入list_thread，你会看到：

两个关键信号：

tshell 状态 = running→ FinSH 在正常跑 ✅
main 状态 = suspend→ main 已经让出 CPU ✅

这时候再发list_device、help等命令，瞬间就有反应了。

八、总结

场景	分析	修法
串口有打印，命令无响应	main 优先级高，空循环霸占 CPU，tshell 饿死	`mdelay`或`return 0`
`list_thread`看到 tshell 是 ready 不是 running	tshell 被饿死	同上
裸机转 RTOS，不习惯 main 退出	调度器接管 CPU，main 退出是安全的	直接`return 0`