Windows下CreateFile打开COM口失败主因是路径未加“.”前缀，如“.COM3”；其次为串口被占用、权限不足或DCB配置错误。
Windows 下用 CreateFile 打开 COM 口失败的常见原因
绝大多数人卡在这一步：明明设备管理器里显示 COM3，但 CreateFile(L"\\.\COM3", ...) 返回 INVALID_HANDLE_VALUE。根本原因是路径格式不对——必须加 \\.\ 前缀，且不能漏掉反斜杠转义；另外，如果串口正被其他程序（如串口调试助手、Arduino IDE）占用，也会失败，GetLastError() 通常返回 ERROR_ACCESS_DENIED。
实操建议：
- 用
QueryDosDevice或枚举注册表HKEY_LOCAL_MACHINE\HARDWARE\DEVICEMAP\SERIALCOMM确认真实存在的 COM 名称，别只信设备管理器“重命名”后的显示名 - 打开时指定
FILE_ATTRIBUTE_NORMAL | FILE_FLAG_OVERLAPPED，即使不用异步 I/O，加上FILE_FLAG_OVERLAPPED能避免某些驱动下同步读写被意外阻塞 - 权限不足时（比如在受限账户下），
CreateFile可能静默失败，务必检查GetLastError()
设置串口参数用 DCB 结构体的坑点
DCB 不是填完就完事——必须先调用 GetCommState 获取当前默认值，再修改关键字段，否则未初始化的字段（如 DCBlength、fDtrControl）会是随机值，导致 SetCommState 失败或行为异常。
关键字段要设对：
立即学习“C++免费学习笔记（深入）”；
-
dcb.DCBlength = sizeof(dcb)必须第一行赋值，否则 Windows 直接拒绝设置 -
dcb.BaudRate = CBR_115200，不要直接写数字，用CBR_宏；非标准波特率需额外调用SetCommState后再验证 -
dcb.ByteSize = 8、dcb.Parity = NOPARITY、dcb.StopBits = ONESTOPBIT这三项不匹配硬件实际配置，收发就会全乱码 -
dcb.fBinary = TRUE必须为真，否则 Windows 可能做 CR/LF 转换，破坏原始字节流
用 ReadFile 和 WriteFile 收发原始字节的注意事项
串口不是管道，ReadFile 默认行为是“等够指定字节数才返回”，这会导致死等。必须用 SetCommTimeouts 关掉这个逻辑，否则一个字节一个字节收数据会卡住。
正确做法：
- 构造
COMMTIMEOUTS：设ReadIntervalTimeout = MAXDWORD（禁用间隔超时），ReadTotalTimeoutConstant = 100（整体最多等 100ms），ReadTotalTimeoutMultiplier = 0 - 每次
ReadFile前清空缓冲区：PurgeComm(hPort, PURGE_RXCLEAR)，尤其在切换波特率或重启通信前，否则旧数据残留干扰新会话 -
WriteFile返回FALSE时，别只看GetLastError()，还要检查lpNumberOfBytesWritten是否等于预期——有些 USB 转串口芯片（如 CH340）会分段写入，需循环调用直到写完
Linux 下用 open("/dev/ttyUSB0", O_RDWR | O_NOCTTY) 的兼容性问题
Linux 没有统一的“枚举 COM 口”API，得靠文件系统扫描：/dev/ttyS*（原生串口）、/dev/ttyUSB*（USB 转串口）、/dev/ttyACM*（CDC ACM 设备）。但不同芯片对应不同设备名，CH340 是 ttyUSB，CP2102 有时是 ttyUSB 有时是 ttyS，STM32 的虚拟串口走 ttyACM。
读写原始字节的关键是终端属性：
- 必须用
tcgetattr/tcsetattr清掉ICANON、ECHO、ISTRIP等标志，否则输入会被行缓存、回显或删掉高位字节 -
c_cflag中设CREAD | CLOCAL，c_iflag清IGNBRK | BRKINT | PARMRK | ISTRIP | INLCR | IGNCR | ICRNL | IXON - 用
cfsetispeed/cfsetospeed设波特率，别直接改c_ispeed/c_ospeed字段
跨平台代码最难缠的是超时和错误恢复：Windows 的 ClearCommError 和 Linux 的 ioctl(fd, TIOCMGET, &status) 行为差异大，一旦线路断开或驱动重置，不重置状态就继续读，大概率拿到全零或乱码数据流。
