如何用c++实现一个跨平台的串口通信程序【系统编程】

推荐使用libserial库实现跨平台串口通信：它基于C++11、轻量无依赖、MIT协议，通过RAII管理资源，统一屏蔽Linux/macOS/Windows底层差异，支持链式配置与流式读写。

用 C++ 实现跨平台串口通信，核心是绕过各系统底层 API 差异，借助成熟、轻量、无依赖的第三方库——libserial（Linux/macOS）或 Windows API + 抽象封装，但更推荐统一使用 libserial 或 QSerialPort（Qt）或 asio + asio-serialport。不过最简洁实用、真正零依赖且纯 C++ 的方案是：采用 cpr + serialport（不推荐）→ 实际应选 libserial（C++11+，头文件少，MIT 协议）或 Boost.ASIO + boost::asio::serial_port（功能强但依赖 Boost）。下面以 libserial 为主给出可直接运行的跨平台实现路径。

选 libserial：轻量、标准 C++、支持 Linux/macOS/WSL，Windows 需稍作适配

libserial 本身原生支持 POSIX（Linux/macOS），Windows 版本需启用 Win32 后端（通过定义 SERIALPORT_WIN32 并链接 setupapi.lib）。它提供类似 iostream 的接口，无需手动处理 termios/DCB，代码干净：

• Ubuntu/macOS：sudo apt install libserial-dev（Debian/Ubuntu）或 brew install libserial
• Windows：从 GitHub 源码编译，启用 -DUSE_WINDOWS_BACKEND=ON，或用 vcpkg：vcpkg install libserial
• 关键头文件只有 #include <serialstream></serialstream>，无全局状态，RAII 管理资源

打开与配置串口：统一语法，自动处理平台差异

libserial 屏蔽了 open() / CreateFile()、cfsetispeed() / SetCommState() 等细节。配置波特率、数据位、停止位、校验直接链式调用：

SerialStream serial_port;
serial_port.Open("/dev/ttyUSB0"); // Linux
// serial_port.Open("COM3");       // Windows（vcpkg 编译版支持）

serial_port.SetBaudRate(SerialStreamBuf::BAUD_115200);
serial_port.SetCharSize(SerialStreamBuf::CHAR_SIZE_8);
serial_port.SetParity(SerialStreamBuf::PARITY_NONE);
serial_port.SetNumOfStopBits(1);
serial_port.SetTimeout(1000); // ms，读超时

登录后复制

注意：Windows 下 COM 口名如 "COM3" 必须加引号；Linux 下常见 /dev/ttyUSB0、/dev/ttyACM0；macOS 为 /dev/cu.usbserial-XXXX。可用 SerialStream::GetAvailablePorts()（新版支持）枚举设备。

立即学习“C++免费学习笔记（深入）”；

标签： linux git go windows github 字节 ubuntu usb 后端 mac ai c++ ios