windows用createfile需“\.comx”格式并检查错误码，linux用open配合termios设波特率、数据位等参数；跨平台优先选libserial或qserialport，但需注意各自依赖与限制。
Windows 下用 CreateFile 打开串口最直接，Linux 下用 open 配合 termios 设置；跨平台别硬写，优先考虑 libserial 或 QSerialPort。
Windows：用 CreateFile 打开 COM 口失败的常见原因
不是权限问题就是路径写错——CreateFile 要求设备名是 \\.\COM3 这种格式，普通 COM3 会直接返回 INVALID_HANDLE_VALUE。另外，如果串口正被其他程序（比如串口助手、IDE 的串口监视器）占用，也会失败，错误码通常是 ERROR_ACCESS_DENIED。
- 必须加
\\.\前缀，哪怕只是COM1也要写成\\.\COM1 - 打开时要传
GENERIC_READ | GENERIC_WRITE，且dwFlagsAndAttributes设为0（非重叠 I/O 更简单） - 调用后立刻用
GetLastError()检查，别只看返回值是否为INVALID_HANDLE_VALUE - 记得在退出前调用
CloseHandle，否则下次打开可能因句柄泄漏失败
Linux：open 后串口没响应？termios 设置漏了这些关键项
Linux 下 open("/dev/ttyUSB0", O_RDWR) 成功只是第一步，不配置 termios，读写基本不可控——默认可能是原始模式关着、回车不换行、输入有缓冲、甚至波特率是 9600 但设备要 115200。
- 必须调用
tcgetattr获取当前设置，再用cfsetispeed/cfsetospeed显式设波特率 -
c_iflag清掉ICRNL和INPCK，避免自动换行和奇偶校验干扰原始数据 -
c_cflag加上CREAD | CLOCAL，并确保CS8（8 数据位）、CREAD（允许读）生效 - 最后用
tcsetattr(fd, TCSANOW, &options)生效，TCSANOW是关键，别用TCSADRAIN等待输出完成（它会卡住）
读写阻塞 vs 非阻塞：为什么 ReadFile 或 read 总是卡住？
默认串口都是阻塞的，ReadFile 在 Windows 或 read 在 Linux 下，若没收到数据就会一直等——这对调试友好，但实际通信中容易让主线程挂死。
立即学习“C++免费学习笔记（深入）”；
- Windows：用
SetCommTimeouts设置ReadIntervalTimeout和ReadTotalTimeoutConstant，比如设为 100ms，超时就返回已读字节数 - Linux：用
fcntl(fd, F_SETFL, O_NONBLOCK)开非阻塞，但要注意read返回 -1 且errno == EAGAIN表示暂无数据，不是错误 - 别在循环里狂读，加个
usleep(10000)或用select/poll监听可读事件更稳
跨平台串口库选哪个？libserial 和 QSerialPort 实际差异
libserial 轻量、头文件少、纯 C++，但 Windows 下依赖 winsock 且对 USB 转串口设备兼容性偶尔翻车；QSerialPort 是 Qt 官方模块，API 统一、信号槽机制方便响应数据到达，但引入整个 Qt 框架成本高，且非 Qt 项目集成稍麻烦。
- 如果你已有 Qt 项目，直接用
QSerialPort，setPortName+open+readyRead信号三步到位 - 纯命令行或嵌入式小项目，选
libserial，注意 Windows 下编译要链接ws2_32.lib，否则SerialStream::open报链接错误 - 两者都不支持热插拔自动识别，得自己轮询
/dev/ttyUSB*或QueryDosDevice列设备
串口真正的坑不在打开和读写，而在数据粘包、校验失败、中断丢失——这些没法靠封装库完全屏蔽，得从协议层设计心跳、帧头帧尾、超时重发。别把底层通信想得太“可靠”。
