cserialport 4.3.2通过统一api抽象windows的createfile/setcommstate、linux的open/tcsetattr等底层差异，用条件编译宏实现轻量跨平台封装，支持handle与int文件描述符统一管理，并提供结构化配置、非阻塞读写及安全资源清理。
串口在 Windows 和 Linux 上的底层差异必须处理
Windows 用 CreateFile 打开 COMx 设备，Linux 用 open("/dev/ttyUSB0", ...)；设置波特率、数据位等参数时，Windows 调 SetCommState，Linux 用 tcsetattr。不抽象掉这些，就谈不上“跨平台封装”。
直接写一套条件编译宏（#ifdef _WIN32 / #ifdef __linux__）是最轻量、最可控的做法——比引入第三方库（如 libserial、QSerialPort）更利于调试和嵌入式部署。
- Windows 下串口句柄是
HANDLE，Linux 下是int文件描述符，类中统一用void*或自定义枚举标识状态，避免类型混用 - Linux 的
termios配置需禁用回显（ICANON | ECHO | ECHONL）、关闭信号（ISIG）、设为非阻塞读（O_NONBLOCK），否则read()可能卡住或吞掉控制字符 - Windows 的
COMMTIMEOUTS必须显式设为ReadIntervalTimeout = MAXDWORD且ReadTotalTimeoutConstant = 0，才能实现类似 Linux 的非阻塞行为
SerialPort::open() 的参数设计要覆盖常见硬件场景
波特率、校验位、停止位、数据位这些参数不能只按标准值硬编码。工业设备常用 1200/2400 波特，有些传感器要求 7 数据位 + 偶校验，而 GPS 模块可能用 8N1 但需要 RTS/CTS 流控。
建议把配置项拆成结构体传入，而不是堆砌 5 个 int 参数，既可读又易扩展：
struct Config {
int baudrate = 9600;
char parity = 'N'; // 'N', 'O', 'E', 'M', 'S'
uint8_t data_bits = 8;
uint8_t stop_bits = 1;
bool rtscts = false;
};
-
parity字符比用枚举更易与 ini 配置文件或 JSON 对齐，解析时只需检查是否在合法集合内 - Linux 下启用 RTS/CTS 需在
termios.c_cflag中加CRTSCTS，Windows 下则调SetupComm+GetCommState后设lpdcb->fRtsControl = RTS_CONTROL_HANDSHAKE - 打开失败时，Linux 返回 -1 并设
errno（如EACCES权限不足、ENODEV设备不存在），Windows 返回INVALID_HANDLE_VALUE，需分别用perror()或FormatMessage()提取错误字符串
读写必须区分“字节流”和“行协议”，且默认不带缓冲
串口本质是字节流设备，read() 返回的是当前内核缓冲区里有多少字节可读，不是一帧数据。很多初学者误以为 read(buf, 1024) 会等满 1024 字节才返回，实际可能只读到 3 个字节就返回了——尤其在低波特率或高噪声环境下。
- 封装类不应自动拼包或做行缓存（比如等
\n才触发回调），那属于上层协议逻辑；类只提供read(uint8_t*, size_t) → ssize_t和write(const uint8_t*, size_t) → ssize_t原语 - Linux 下若用
select()等待可读，注意FD_SETSIZE限制和多线程 fd 复用风险；Windows 下推荐用WaitForSingleObject等事件对象，比轮询PeekComm更省 CPU - 每次
read()前应检查串口是否仍处于打开状态（is_open()），Linux 下 fd 可能被意外 close，Windows 下句柄可能被其他线程关闭，直接 read 会 crash
析构时务必同步清理资源，防止句柄泄漏
串口设备不像文件能靠系统自动回收。Windows 下未 CloseHandle 的 COM 口可能被锁死，导致下次打开报 ERROR_ACCESS_DENIED；Linux 下未 close 的 fd 会持续占用，/dev/ttyS0 类设备还可能影响系统串口控制台。
- 析构函数中先调
close()，再将内部句柄/描述符置为无效值（如 Windows 设m_hPort = INVALID_HANDLE_VALUE，Linux 设m_fd = -1），避免二次 close - 禁止在析构中抛异常——串口关闭失败（如硬件拔出）是常见情况，应记录日志而非中断流程
- 如果支持移动语义（C++11+），移动构造/赋值后原对象必须清空句柄，否则被移动走的对象析构时会 double-close
跨平台串口类最难的不是打开和收发，而是边界条件：热插拔检测、权限变化、驱动重载、信号干扰导致的帧错位。这些没法靠一层封装解决，得在业务层加超时重试、校验重同步、环形缓冲区防丢包——封装类只负责把 OS 差异藏好，别让它漏出来。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
