C#如何使用SerialPort类？SerialPort类的正确用法与注意事项有哪些

C#的SerialPort类位于System.IO.Ports命名空间下，是.NET框架为开发者提供的串口通信封装类，能够简化串口打开、参数配置、数据收发、关闭等全流程操作，广泛应用于工业设备对接、嵌入式硬件通信、传感器数据读取等场景。

SerialPort类的基础配置与打开

使用SerialPort类前需要先引入对应的命名空间，基础配置需要设置串口名称、波特率、数据位、停止位、校验位等核心参数，配置完成后调用Open方法打开串口。

using System.IO.Ports;

namespace SerialPortDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建SerialPort实例
            SerialPort serialPort = new SerialPort();
            // 设置串口名称，对应设备管理器中的COM口
            serialPort.PortName = "COM3";
            // 设置波特率，需与对接设备保持一致
            serialPort.BaudRate = 9600;
            // 设置数据位，常用值为8
            serialPort.DataBits = 8;
            // 设置停止位，常用值为One
            serialPort.StopBits = StopBits.One;
            // 设置校验位，无校验为None
            serialPort.Parity = Parity.None;
            // 设置读取超时时间，单位毫秒
            serialPort.ReadTimeout = 500;
            // 设置写入超时时间，单位毫秒
            serialPort.WriteTimeout = 500;
            
            try
            {
                // 打开串口
                serialPort.Open();
                Console.WriteLine("串口打开成功");
            }
            catch (UnauthorizedAccessException ex)
            {
                Console.WriteLine("串口访问被拒绝，可能被其他程序占用：" + ex.Message);
            }
            catch (Exception ex)
            {
                Console.WriteLine("打开串口失败：" + ex.Message);
            }
        }
    }
}

数据发送与读取的实现方式

数据发送

SerialPort类提供了多种数据发送方法，既可以发送字符串，也可以发送字节数组，发送前需要确认串口已经处于打开状态。

// 发送字符串，会自动按照编码转换为字节
serialPort.WriteLine("AT+TEST");
// 发送字节数组，适合传输二进制数据
byte[] sendData = new byte[] { 0x01, 0x02, 0x03, 0x04 };
serialPort.Write(sendData, 0, sendData.Length);

数据读取

数据读取分为同步读取和异步读取两种方式，同步读取会阻塞当前线程，适合简单场景；异步读取通过事件触发，不会阻塞主线程，适合需要同时处理其他逻辑的场景。

同步读取方式

try
{
    // 读取一行数据，直到遇到换行符
    string readLine = serialPort.ReadLine();
    Console.WriteLine("读取到的行数据：" + readLine);
    // 读取所有可用字节
    byte[] readBuffer = new byte[serialPort.BytesToRead];
    int readCount = serialPort.Read(readBuffer, 0, readBuffer.Length);
    Console.WriteLine("读取到的字节数：" + readCount);
}
catch (TimeoutException ex)
{
    Console.WriteLine("读取超时：" + ex.Message);
}

异步读取方式（推荐）

通过绑定DataReceived事件实现异步读取，当串口接收到数据时自动触发事件处理逻辑，需要注意事件回调不在UI线程，操作UI时需要做跨线程处理。

// 绑定数据接收事件
serialPort.DataReceived += SerialPort_DataReceived;

// 事件处理方法
private static void SerialPort_DataReceived(object sender, SerialDataReceivedEventArgs e)
{
    SerialPort sp = (SerialPort)sender;
    // 延迟一小段时间，确保所有数据都接收完成
    System.Threading.Thread.Sleep(20);
    string receiveData = sp.ReadExisting();
    Console.WriteLine("异步接收数据：" + receiveData);
}

使用SerialPort类的注意事项

• 串口打开前需要检查是否被占用，避免抛出UnauthorizedAccessException异常，打开后需要判断IsOpen属性确认状态。
• DataReceived事件的触发时机不确定，数据可能分多次到达，不要假设一次事件就能拿到完整数据包，需要自己做数据缓存和分包处理。
• 操作UI的场景下，事件回调线程不是UI线程，WPF或WinForm程序需要使用对应的跨线程调用方法更新UI，避免线程冲突。
• 使用完成后必须调用Close方法关闭串口，同时调用Dispose方法释放资源，建议放在try-finally块中执行，避免资源泄漏。
• 读写超时时间需要根据实际场景设置，过短容易频繁超时，过长会导致程序响应变慢，默认值为500毫秒，可根据数据量调整。
• 编码问题需要注意，默认编码为ASCII，如果对接设备使用UTF8或其他编码，需要设置Encoding属性，避免中文或特殊字符乱码。

常见问题排查

如果出现数据丢失问题，首先检查波特率、数据位等参数是否与设备完全一致，其次检查是否做了完整的分包处理；如果程序卡顿，优先检查是否使用了同步读取且没有设置合理的超时时间；如果串口无法打开，检查端口名称是否正确，是否被其他程序占用。

C#SerialPort串口通信异步读取修改时间：2026-06-28 07:24:28