C#中SerialPort.ReadLine()导致程序冻结的问题求助

阿华AIGC实验室

2026-5-21

问题分析与解决方案

首先看你的代码，有几个关键问题导致程序挂起：

1. SerialPort 变量作用域错误

你在button1_Click里定义了局部的SerialPort变量，但timer1_Tick里却直接使用port——这说明你可能在类里还定义了一个全局的port变量，但局部变量覆盖了它，导致全局的port根本没被初始化和打开。这会导致要么编译错误，要么运行时找不到有效的串口对象。

2. ReadLine() 的阻塞特性

ReadLine()是阻塞式方法：它会一直等待，直到收到换行符（\n）或者超时。而你的Arduino程序如果只是发送"1"或"0"，没有附带换行符的话，ReadLine()会一直卡在那里，直到触发ReadTimeout异常。而Timer的Tick事件是在UI线程执行的，阻塞UI线程就会导致程序看起来“挂起”。

3. 未提前检查可用数据

你猜测的方向是对的：直接调用读取方法前，必须先确认串口有数据可读，否则很容易阻塞。

修复方案

方案一：改进Timer方式（同步读取，适合简单场景）

首先把SerialPort改成类的成员变量，然后在Tick事件里先检查数据再读取，同时确保Arduino发送带换行符的数据：

步骤1：修正Arduino代码

确保发送数据时用println而不是print，这样会自动添加换行符：

// Arduino示例代码
const int buttonPin = 2;
int buttonState;
int lastButtonState = HIGH;

void setup() {
  Serial.begin(9600);
  pinMode(buttonPin, INPUT_PULLUP);
}

void loop() {
  buttonState = digitalRead(buttonPin);
  if (buttonState != lastButtonState) {
    if (buttonState == LOW) {
      Serial.println("1"); // 发送"1"+换行符
    } else {
      Serial.println("0"); // 发送"0"+换行符
    }
    lastButtonState = buttonState;
    delay(50); // 消抖
  }
}

步骤2：修改C#代码

// 把SerialPort定义为类的成员变量
private SerialPort port;

private void button1_Click(object sender, EventArgs e) {
  // 先关闭已打开的串口（避免重复打开）
  if (port != null && port.IsOpen) {
    port.Close();
  }

  port = new SerialPort();
  port.BaudRate = 9600;
  port.PortName = "COM4";
  port.ReadTimeout = 1000;
  // 确保换行符匹配Arduino的输出
  port.NewLine = "\n";
  
  try {
    port.Open();
    timer1.Start();
  } catch (Exception ex) {
    MessageBox.Show("打开串口失败：" + ex.Message);
  }
}

private void timer1_Tick(object sender, EventArgs e) {
  // 先检查是否有可用数据
  if (port != null && port.IsOpen && port.BytesToRead > 0) {
    try {
      string ee = port.ReadLine();
      // 移除可能的空白字符（比如回车）
      ee = ee.Trim();
      // 确保在UI线程更新ListBox
      if (listBox1.InvokeRequired) {
        listBox1.Invoke(new Action(() => listBox1.Items.Add(ee)));
      } else {
        listBox1.Items.Add(ee);
      }
    } catch (TimeoutException) {
      // 超时忽略，继续等待下一次Tick
    } catch (Exception ex) {
      MessageBox.Show("读取数据失败：" + ex.Message);
      timer1.Stop();
      port.Close();
    }
  }
}

方案二：使用DataReceived事件（异步读取，更推荐）

这种方式不需要Timer，串口有数据时会自动触发事件，不会阻塞UI线程：

private SerialPort port;

private void button1_Click(object sender, EventArgs e) {
  if (port != null && port.IsOpen) {
    port.Close();
  }

  port = new SerialPort();
  port.BaudRate = 9600;
  port.PortName = "COM4";
  port.NewLine = "\n";
  
  // 绑定数据接收事件
  port.DataReceived += Port_DataReceived;
  
  try {
    port.Open();
  } catch (Exception ex) {
    MessageBox.Show("打开串口失败：" + ex.Message);
  }
}

private void Port_DataReceived(object sender, SerialDataReceivedEventArgs e) {
  SerialPort sp = (SerialPort)sender;
  try {
    string data = sp.ReadLine().Trim();
    // 必须用Invoke更新UI，因为DataReceived事件在非UI线程
    listBox1.Invoke(new Action(() => listBox1.Items.Add(data)));
  } catch (Exception ex) {
    MessageBox.Show("读取数据失败：" + ex.Message);
    sp.Close();
  }
}