Go串口通信失败主因是平台差异、超时缺失、帧边界处理不当和资源管理错误；须按系统选对端口路径、设Read/Write超时、用bufio分帧、禁用多goroutine共用端口、退出前Close。
Go 做串口通信不难，但直接照抄示例代码十有八九会在真实设备上卡住——不是读不到数据，就是写出去没响应，或者换台电脑就打不开端口。核心问题不在语法，而在平台差异、超时控制、帧边界处理和资源生命周期这四点。
串口打不开：Permission denied 或 device not found
这不是 Go 代码写错了，是系统级权限或路径不匹配。
- Linux 下先运行
ls /dev/tty*看真实设备名（比如/dev/ttyUSB0），再确认用户是否在dialout组：sudo usermod -a -G dialout $USER，改完要重新登录 - macOS 别用
/dev/tty.*，选/dev/cu.*开头的（例如/dev/cu.usbserial-1420），否则可能被系统串口控制台占用 - Windows 必须写全大写
COM3，不能写com3或\.COM3（tarm/serial内部已处理前缀，硬加反而报错） - 别硬编码端口名，用
serial.GetPortsList()先探测，或让用户通过命令行参数传入
Read() 一直阻塞或返回 0 字节
Go 的 Read() 默认是阻塞式，且 tarm/serial 不设超时就永远等下去，硬件发得慢、断帧、空闲线状态都会导致卡死。
- 必须在
serial.Config中显式设置Timeout: 100 * time.Millisecond -
n, err := s.Read(buf)后务必检查：n == 0 && err == nil是正常空读；err == io.EOF往往是 USB 转串口芯片断连后残留句柄 - 如果协议有帧头（如
0x7E）或换行符结尾，别用固定长度读，改用bufio.NewReader(s)配合ReadBytes(' ')，或自己循环拼包
Write() 返回成功但设备无反应
Go 层面写入成功 ≠ 数据真正到达设备。电平、握手、终止符、写入节奏都可能出问题。
立即学习“go语言免费学习笔记（深入）”；
- 查清硬件手册：是否需要 RTS/CTS？在
serial.Config中打开RtsCts: true或DtrDsr: true - 很多设备要求命令以
"AT"不行，得写[]byte("AT ") - CH340、CP2102 等芯片对连续写入敏感，两次
Write()之间加time.Sleep(10 * time.Millisecond) - 用串口调试助手抓一包，对比 Go 发出的 hex 和手动发送是否完全一致——少一个
0x0D或多一个0x00都会失败
goroutine 并发读写时 panic 或数据错乱
serial.Port 实例不是线程安全的，多个 goroutine 直接共用会崩溃或丢数据。
- 绝对不要在多个 goroutine 里共享同一个
*serial.Port句柄 - 高频读写场景：用
sync.Mutex包一层，读写前mu.Lock()，完后mu.Unlock() - 低频交互（如配置命令）：每个 goroutine 自己
OpenPort()→ 操作 →Close()，更简单可靠 - 程序退出前必须
defer s.Close()，否则下次运行会报device busy
最常被忽略的是 ReadTimeout 和帧解析逻辑——90% 的“读不到数据”问题，其实只是没设超时，然后卡在那干等；而协议层没做分包，导致一次 Read() 拿到半帧或两帧粘连，后续解析全乱。这两点不解决，其他都白搭。
