windows下打开com口失败主因是路径未加“.”前缀，如“.com3”；dcb配置后须调用setcommstate且先getcommstate；读写需设超时或事件机制；linux需将用户加入dialout组并用稳定设备链接。
Windows 下用 CreateFile 打开 COM 口失败，返回 INVALID_HANDLE_VALUE
多数时候不是权限或驱动问题，而是路径写错了。Windows 要求串口设备名必须带 \. 前缀，比如打开 COM3 得写成 \.COM3，漏掉双反斜杠或点，CreateFile 就直接失败。
- 正确写法：
CreateFile(L"\.COM3", ...)（注意是四个反斜杠，转义后为两个） - 错误写法：
CreateFile("COM3", ...)、CreateFile("COM3", ...)、CreateFile("\.COM3", ...) - 如果 COM 编号 ≥ 10（如
COM10），不加\.前缀会直接被系统忽略——这是 Windows 特有的限制，不是 C++ 问题 - 调用后务必检查返回值，并用
GetLastError()看具体错误码：ERROR_ACCESS_DENIED是权限/占用，ERROR_FILE_NOT_FOUND基本就是路径格式不对
设置波特率和数据格式用 DCB 结构体总不生效
DCB 本身只是个配置容器，填完必须调用 SetCommState 才真正下发到硬件；而且得先用 GetCommState 把当前默认值读出来再改，不能只初始化部分字段然后直接塞进去。
- 必须步骤：
GetCommState(hPort, &dcb); dcb.BaudRate = CBR_115200; dcb.ByteSize = 8; dcb.Parity = NOPARITY; dcb.StopBits = ONESTOPBIT; SetCommState(hPort, &dcb); - 常见坑：
dcb.DCBlength = sizeof(dcb)必须设对，否则SetCommState拒绝执行 - 波特率宏要用
CBR_开头的（如CBR_9600），别手误写成数字9600——DCB里BaudRate是DWORD，但 Windows 内部靠这个宏识别是否为标准速率 - 某些 USB 转串口芯片（如 CH340）对非标波特率支持差，设
CBR_123456可能静默降频到最近支持值，建议优先选标准速率
读写时程序卡死在 ReadFile 或 WriteFile
默认串口是阻塞模式，没数据可读或缓冲区满时就会一直等。这不是 bug，是 Windows 的设计行为，得主动配超时和非阻塞逻辑。
- 关键配置：
SetCommTimeouts(hPort, &commtimes)，其中commtimes.ReadIntervalTimeout = MAXDWORD表示“每字节之间最大等待时间”，设成0才真正非阻塞；ReadTotalTimeoutConstant控制整次读的最长等待 - 更稳妥做法：用
WaitForSingleObject配合串口事件（SetCommMask+WaitCommEvent），避免轮询或死等 -
WriteFile卡住常见于对方设备没应答、流控开启但没连 RTS/CTS 线——先关掉硬件流控：dcb.fOutxCtsFlow = FALSE; dcb.fRtsControl = RTS_CONTROL_DISABLE; - 记得给读写缓冲区预留足够空间，
ReadFile在超时前可能只读到部分数据，需循环调用直到满足预期长度
Linux 下用 open("/dev/ttyUSB0", O_RDWR) 权限拒绝
不是代码问题，是用户没加进 dialout 用户组。Ubuntu/Debian 系默认只有该组成员能访问串口设备，root 运行虽能过，但不该是常态方案。
立即学习“C++免费学习笔记（深入）”；
- 终端执行：
sudo usermod -a -G dialout $USER，然后**完全退出当前桌面会话再重登**（仅重启 shell 不生效） - 验证是否生效：
groups输出里要有dialout，且ls -l /dev/ttyUSB0显示组权限含wr - 设备名不固定：拔插 USB 串口后可能变成
ttyUSB1，建议用/dev/serial/by-id/下的稳定软链接（如/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0） - 别忘了
cfsetispeed/cfsetospeed设置波特率，tcsetattr提交，且要设termios.c_cflag |= CREAD | CLOCAL启用接收和忽略 modem 控制信号
串口通信真正的麻烦不在 API 调用本身，而在不同平台对“同一概念”的实现差异——比如 Windows 的 \. 前缀、Linux 的用户组权限、CH340 对波特率的容忍度、甚至一根没接好的地线。这些细节不试到报错，很难凭文档猜中。