设备连不上，找不到端口
- 换一根确认支持数据传输的 USB Type-C 线，很多充电线只有供电没有数据
- 直连电脑原生 USB 口，避开无供电 HUB 和扩展坞
- Windows 10 与 11 通常免驱，Windows 7 需手动安装串口驱动
- 打开设备管理器，看有没有出现新的串口并记下串口号
上传失败或报路径错误
- spawn ENAMETOOLONG：Mind+ 解压路径过长或含中文、括号，换一个短的纯英文路径
- 扩展里搜不到 K10：Mind+ 版本低于 V1.8.1 RC1.0，升级后再试
- 串口选错或被占用：关掉其他串口监视器，重新选择端口
上传后一直重启，或屏幕不亮
- 用恢复设备初始化设置，或在 Mind+ V2 里使用擦除功能
- 恢复时先按住 BOOT 再接 USB，识别到端口后松开
- 重新上传一个最简单的显示程序验证板子是否恢复正常
另外有一种情况不是故障，只拖了缓存显示文字、没配显示更新积木，屏幕本来就不会有任何变化。
AI 程序跑着跑着崩溃
板载 AI 功能涉及 TF 卡时，劣质或格式不对的卡是常见元凶。官方建议用 16G 或 32G 官方卡并格式化为 FAT32。
- 换卡后先跑官方示例确认稳定，再一点点加自己的逻辑
- 屏幕显示积木放进回调、线程、MQTT 接收或中断里，也容易造成显示异常甚至卡死
连不上 WiFi 或 SIoT
- K10 只支持 2.4 GHz，确认路由器的 2.4G 热点开着
- 电脑与 K10 不在同一局域网，或电脑防火墙挡了 8080 端口
- SIoT 页面默认账号 siot、密码 dfrobot，主题名要与订阅端一致
排查心法
先分层定位，是电脑认不到板子、是程序烧不进去，还是烧进去以后自己跑崩。每轮只改一个变量，从最短的官方示例往回加功能，比在完整项目里瞎猜快得多。
下一步
问题都排完了，回到行空板 K10 快速开始，按阅读顺序把整个项目再过一遍。