围绕 Python 串口开发在 Windows、Linux、macOS 等平台上的实际差异，对主流串口库的系统兼容性、API 特性、通信性能、异常处理与工程选型进行对比，并通过统一测试方法帮助开发者验证库的表现、规避常见兼容性问题。
先明确跨平台串口开发需求与测试环境
跨平台串口开发的首要任务是厘清各操作系统的底层差异。Windows 通常以 COM1、COM2 等命名，依赖系统自带或厂商提供的 CDC/ACM 驱动；Linux 采用 /dev/ttyUSB0 或 /dev/ttyACM0，需将用户加入 dialout 或 tty 组以获取读写权限；macOS 则使用 /dev/cu.usbserial-xxx 或 /dev/tty.usbserial-xxx，且受 SIP 机制限制需手动授权终端访问。测试环境需统一硬件（如 FTDI 或 CH340 芯片的 USB 转串口模块），固定物理连接，并明确核心指标：波特率（如 9600/115200）、单次传输数据量（如 1KB 至 1MB）、端到端延迟阈值、7×24 小时稳定性要求及多串口并发场景。建议在 CI/CD 流水线中配置三平台虚拟机或物理机，使用 udev 规则（Linux）或注册表脚本（Windows）固化端口映射，确保后续对比基准一致。
对比主流Python串口库的兼容性与API差异
目前 Python 生态中 pyserial 是事实标准，但其 API 在不同平台存在细微差异。端口枚举方面，Windows 依赖注册表扫描，Linux/macOS 读取 /sys/class/tty 或 /dev/tty.*，代码中应使用 serial.tools.list_ports.comports() 统一获取。打开串口时，需显式指定 timeout 与 write_timeout，避免跨平台阻塞行为不一致。读写操作上，read() 和 write() 默认处理字节流，但 Windows 对换行符的底层转换更敏感，建议统一使用 bytes 类型并关闭文本模式。硬件流控（RTS/CTS、DTR/DSR）在 macOS 上可能因驱动实现不完整而失效，需通过 ser.rtscts = True 显式开启并捕获 SerialException。异常处理应包裹 serial.SerialException 与 OSError，并在 finally 块中调用 ser.close() 释放句柄，防止 Linux 下文件描述符泄漏。
用统一基准测试分析串口通信性能
性能评估必须依赖可复现的基准测试，而非主观感受。测试脚本应设计为双向回环模式：主机通过虚拟串口对（如 socat 或 com0com）或物理短接 TX/RX 发送定长数据包（如 1024 字节），记录发送与接收时间戳以计算吞吐量与往返延迟。使用 time.perf_counter() 替代 time.time() 提升精度。CPU 占用可通过 psutil 或平台原生工具采样。针对高频数据（如 115200 波特率下持续 10 分钟），需监控 serial.Serial.in_waiting 缓冲区状态，验证是否出现数据截断或丢包。建议引入多线程生产者-消费者模型，主线程负责写入，后台线程异步读取并统计丢帧率。连续运行 24 小时后，对比各平台内存泄漏情况与串口句柄稳定性，确保性能数据具备统计学意义。
排查跨平台兼容性问题与性能陷阱
跨平台调试常遇水土不服陷阱。首当其冲是端口名与权限：Linux 报 Permission denied 需执行 sudo usermod -aG dialout $USER；macOS 提示 Resource busy 往往因系统后台进程占用，需 lsof /dev/cu.* 排查。编码与换行符问题频发于文本协议，务必使用 ser.write(b'AT\r\n') 而非字符串，并设置 ser.newline = b'\r\n'。超时设置不当会导致 read() 永久阻塞，推荐采用非阻塞轮询结合 select 模块或 asyncio 事件循环。缓冲区溢出常见于未及时处理 in_waiting 数据，应定期调用 ser.reset_input_buffer() 清空残留。多线程模型下，pyserial 非线程安全，需引入 threading.Lock 保护读写操作，或改用独立进程通信。通过日志分级记录 SerialException 堆栈，可快速定位驱动兼容性或硬件断连根因。
根据项目场景选择串口库并完成跨平台验证
选型需建立多维评估矩阵。若项目仅需基础收发且覆盖全平台，pyserial 凭借十年迭代与完善文档仍是首选；若追求极致低延迟与异步架构，可评估 aio-serial 或基于 libserialport 的封装方案。评估维度应包含：目标平台覆盖率、API 学习曲线、社区活跃度（GitHub Issues 响应速度）、许可证兼容性（BSD/MIT 优先）。确定候选库后，必须在真实业务设备（如工业 PLC、传感器模块）上进行回归测试。流程包括：编写自动化测试用例覆盖正常通信、异常拔插、波特率切换与高负载场景；在 Windows/Linux/macOS 三端同步执行，收集吞吐量、错误率与崩溃日志；通过 Docker 或 GitHub Actions 实现跨平台 CI 验证。最终方案需附带降级策略（如串口不可用时切换至 TCP 模拟），确保工程交付的鲁棒性。
