如何在离线时用Python模拟串口命令进行无报错调试？

以下几种方案都能避免在业务逻辑中加入判断语句，保持代码可读性，同时实现串口交互的模拟调试：

1. 依赖注入+自定义模拟串口类 #

定义一个和真实串口类（比如pySerial的Serial）接口完全一致的模拟类，通过初始化参数切换真实/模拟实例，业务逻辑无需修改。

示例代码： #

# 模拟串口类，完全复刻真实串口的核心方法
class MockSerial:
    def __init__(self, port=None, baudrate=9600, **kwargs):
        self.port = port
        self.baudrate = baudrate
        # 预存模拟的设备回复数据
        self.receive_buffer = b"DEVICE_READY\r\n"

    def write(self, data):
        print(f"[模拟发送] {data}")
        return len(data)

    def readline(self):
        # 模拟读取一行数据
        line_end = self.receive_buffer.find(b"\n")
        if line_end == -1:
            return b""
        result = self.receive_buffer[:line_end+1]
        self.receive_buffer = self.receive_buffer[line_end+1:]
        return result

    def close(self):
        print("[模拟串口已关闭]")

# 真实串口实例化函数
import serial
def get_serial(port, baudrate=9600, use_mock=False):
    if use_mock:
        return MockSerial(port, baudrate)
    return serial.Serial(port, baudrate, timeout=1)

# 业务逻辑：完全不关心串口是真实还是模拟
def interact_with_device(serial_conn):
    serial_conn.write(b"GET_STATUS\r\n")
    response = serial_conn.readline()
    print(f"[设备回复] {response.decode().strip()}")

# 在家调试时传入use_mock=True，工作时传False
serial_conn = get_serial("COM3", use_mock=True)
interact_with_device(serial_conn)
serial_conn.close()

2. 使用unittest.mock动态替换真实串口类 #

利用Python标准库的unittest.mock直接patch真实串口类，配置模拟返回值，无需额外编写模拟类，适合快速调试或单元测试。

示例代码： #

from unittest.mock import patch, Mock
import serial

# 业务逻辑代码（无任何调试判断）
def interact_with_device(serial_conn):
    serial_conn.write(b"QUERY_DATA\r\n")
    response = serial_conn.readline()
    print(f"[收到数据] {response}")

# 调试时通过上下文管理器替换真实串口
with patch("serial.Serial") as mock_serial_cls:
    # 配置模拟实例的行为
    mock_serial = mock_serial_cls.return_value
    mock_serial.readline.return_value = b"SIMULATED_DATA: 123\r\n"

    # 正常调用业务逻辑，完全不用修改
    ser = serial.Serial("COM3", 9600)
    interact_with_device(ser)

3. 虚拟串口+简易模拟设备程序 #

使用虚拟串口工具创建一对互连的虚拟串口（Windows用com0com，Linux用tty0tty），再写一个简单的模拟设备程序监听其中一个串口，你的主程序连接另一个串口，完全模拟真实设备交互，代码无需任何修改。

模拟设备示例代码： #

import serial

# 连接虚拟串口的一端（比如COM2）
sim_device = serial.Serial("COM2", 9600, timeout=1)
print("[模拟设备启动] 等待指令...")

while True:
    cmd = sim_device.readline()
    if cmd:
        print(f"[收到指令] {cmd}")
        # 根据指令返回模拟数据
        if b"GET_TEMP" in cmd:
            sim_device.write(b"TEMP: 25.5\r\n")
        elif b"GET_HUM" in cmd:
            sim_device.write(b"HUM: 60%\r\n")

你的主程序正常连接虚拟串口的另一端（比如COM1），就能和这个模拟设备实时交互，和真实场景完全一致。

内容的提问来源于stack exchange，提问作者2WFR