C#怎么实现串口通信_C#使用SerialPort控件接收数据【开发手册】

林译川

2026-09-15 • 👁 0人浏览过

SerialPort是System.IO.Ports下的类而非WinForm控件，需手动new初始化；DataReceived事件不在UI线程触发，更新控件须Invoke；推荐用Read()配合缓冲区解析帧，避免ReadLine()丢数据；关闭前应解绑事件并清空缓冲区。串口通信在 C# 中不是靠“控件”实现的，

SerialPort

是一个类，不是 WinForm 控件；直接拖控件到窗体上是无效的。 SerialPort 初始化必须手动 new，不能靠设计器拖拽很多人在 WinForm 里找

SerialPort

控件，结果发现工具箱里没有——因为它根本不是控件。它是

System.IO.Ports

命名空间下的一个托管类，必须代码实例化：

using System.IO.Ports;

SerialPort port = new SerialPort("COM3", 115200) { DataBits = 8, Parity = Parity.None, StopBits = StopBits.One, ReadTimeout = 500, WriteTimeout = 500 };

不设置

ReadTimeout

WriteTimeout

，

ReadLine()

或

ReadExisting()

可能永远卡住

PortName

必须是真实存在的串口号，

SerialPort.GetPortNames()

可查，但返回值不保证设备在线构造函数里只传

PortName

和

BaudRate

是最简写法，其他属性必须显式赋值，不会自动继承默认值 DataReceived 事件在 UI 线程外触发，直接更新控件会抛异常

DataReceived

是基于 IOCP 的异步回调，执行线程不是 UI 线程。直接在事件处理器里写

textBox1.Text += data;

会触发

InvalidOperationException: 跨线程操作无效

。 WinForm 下必须用

this.Invoke()

或

this.BeginInvoke()

封装 UI 更新逻辑 WPF 下要用

Dispatcher.Invoke()

别在事件里做耗时解析（比如大包拆帧、CRC 校验），否则会阻塞后续接收；建议把原始

byte[]

丢进队列，另起线程处理 ReadExisting() 和 ReadLine() 容易丢数据，别无脑用

ReadExisting()

返回的是当前缓冲区全部字符串（按当前

Encoding

解码），但串口数据是流式到达的，没换行符就可能截断半帧；

ReadLine()

依赖换行符，而很多嵌入式设备根本不发

\r\n

。 C知道 CSDN推出的一款AI技术问答工具下载更可靠的做法是用

port.BytesToRead

判断有无数据，再调用

port.Read(byte[], 0, count)

按需读取指定长度如果协议有帧头（如

0xAA 0x55

）和长度字段，应自己实现缓冲区累积 + 帧同步逻辑，而不是依赖内置读取方法

Encoding

必须和设备端一致；ASCII 编码无法正确处理中文或扩展 ASCII 字符，设备返回二进制指令时建议全程用

byte[]

处理 Close() 前必须确保没有正在执行的异步操作调用

port.Close()

会立即释放句柄，但若此时

DataReceived

回调还没执行完，或后台还有未完成的

Write()

，可能引发

ObjectDisposedException

或数据丢失。关闭前先设

port.DataReceived -= handler

解绑事件用

lock

或

CancellationToken

控制写入线程，确保

Write()

调用已退出调用

port.DiscardInBuffer()

和

port.DiscardOutBuffer()

清空残留数据，避免下次打开时读到旧包实际项目中建议封装成 IDisposable 类，用

using

确保资源释放真正难的从来不是“连上串口”，而是设备协议不规范、线缆干扰导致帧错乱、超时边界模糊、多线程竞争写缓冲区——这些细节不压到实操层面，光看示例代码永远跑不通现场设备。

相关文章