尧图网站开发 
简介这是一份采用Python与PyQt5编写的串口读取与显示小程序源码面向Python初学者、单片机开发者和需要快速搭建上位机的学生解决了从串口接收数据、将数据写入SQLite数据库以及通过UI界面动态显示这三类常见问题。压缩包总计14个文件体积仅16KB核心是两个py脚本一个负责界面逻辑另一个负责数据处理与数据库操作其余7个xml配置、3个meta文件及IML文件主要用于PyCharm工程结构识别pyc文件则是运行时生成的缓存。该资源已有7055人学习代码量虽小但完整覆盖了串口初始化、接收解析、数据入库和列表/控件刷新等必要环节并配有db数据目录和工程配置文件可直接导入PyCharm观察效果。阅读源码后可以清楚对比PyQt5信号槽调用、sqlite3写入事务和串口库read/readline的配合方式非常适合作为课程设计、毕业设计或嵌入式调试工具开发的参考模板。 直接开始。写这篇东西的起因挺简单我手头有个传感器模块需要用上位机把串口发回来的数据实时画成曲线本来想找个现成的串口调试助手凑合用结果要么功能太重要么界面难看要么就是收数没问题但显示只能看文本。折腾一圈之后我决定自己用 PyCharm PyQt5 写一个前前后后花了两个晚上把串口读取、数据显示、界面刷新这条路全走通了。这篇文章就把完整实现过程、关键代码和踩过的坑都整理出来给同样想自己做串口上位机的朋友一条能直接抄的路。先说清楚这玩意儿能干什么通过 PyQt5 的串口模块接收设备发来的数据在界面上实时显示原始文本和解析后的数值还能把接收到的数据保存到本地文件。适合所有需要快速搭建串口调试工具的场景不管你是调试 STM32、Arduino还是跟各种传感器模块打交道这套代码都能直接用。你不需要太深的 PyQt 基础跟着步骤走就行。1. 环境准备PyCharm 里把 PyQt5 和串口库一次装好动手写代码之前先把环境搞定。工欲善其事必先利其器在 PyQt5 串口这条路上最容易翻车的就是环境配置阶段。1.1 Python 解释器和虚拟环境的坑我用的 PyCharm 是社区版免费的就够用专业版的功能在普通串口调试场景里用不上。Python 版本建议 3.8 到 3.11 之间别用最新的 3.12因为部分 PyQt5 的依赖库可能还没完全适配实测 3.12 跑 PyQt5 偶尔会报 Qt 平台插件相关的错折腾起来比较浪费时间。打开 PyCharm 新建项目时建议勾选“New environment using Virtualenv”让每个项目单独拥有一套依赖环境。很多新手图省事直接删掉虚拟环境装到全局 Python 里结果不同项目之间依赖冲突串口库版本互相污染后期排查很痛苦。虚拟环境这个习惯值得养成。1.2 PyQt5 与串口库的安装依赖安装直接用 pip在 PyCharm 底部的 Terminal 里执行pip install PyQt5 pyqt5-tools pyserial这里我解释一下三个包的各自职责别装完就忘PyQt5界面框架负责窗口、按钮、文本框、布局这些 UI 组件。pyqt5-tools包含了 Qt Designer 可视化设计工具虽然不是必须但用它拖界面比自己纯手敲代码快很多推荐装。pyserial独立的串口操作库PyQt5 本身不直接提供串口功能需要借助 pyserial 或 PyQt5 自带的 QtSerialPort。这里我用 pyserial因为它在跨平台方面更稳定代码也更直观。测试安装是否成功在终端里执行from PyQt5.QtWidgets import QApplication import serial print(OK)只要不报错环境就通了。如果这里报 ModuleNotFoundError先检查是不是虚拟环境没有激活或者 PyCharm 的项目解释器没切到虚拟环境。1.3 串口驱动别让设备悄悄失踪如果你的设备是 USB 转串口比如常见的 CH340、FTDI、CP2102 这些芯片系统没装驱动的话PySerial 里根本看不到对应端口。Windows 下连接设备后在“设备管理器”的“端口COM 和 LPT”里检查如果显示黄色感叹号就是驱动问题。CH340 的驱动需要从官网或厂商页面下载FTDI 的驱动通常 Windows 10 以上系统会自动安装。装完驱动后务必重启 PyCharm 或者重新插拔设备否则端口列表不会刷新。另外检查端口是否可用可以用下面的小命令python -m serial.tools.list_ports这个命令会列出所有可用的 COM 端口有个端口列表的显示帮你确认设备是否正常连接。2. 界面设计用最简单的方式搭出串口调试工具我建议先用 Qt Designer 直接把界面样子拖出来省时省力再转成 Python 代码。当然如果你对代码熟也可以直接纯手写。这里两种方式都说一下因为不同的人习惯不同。2.1 Qt Designer 可视化拖拽布局启动 Qt Designer 的方式是在终端执行pyqt5-tools designer会弹出可视化的窗体设计工具。新建一个 Main Window从左边控件面板拖入以下内容左侧串口配置区域放几个 QLabel 和 QComboBox分别用于端口选择、波特率选择、数据位、停止位、校验位再加一个“打开串口”按钮。中间接收数据区域放一个 QTextEdit设置为只读用于显示原始文本下面放一个 QLineEdit 和一个“发送”按钮用于发送数据。右侧或底部数据显示区域放一个 QLabel 来动态显示解析后的数值或者干脆用一个 QPlainTextEdit。按照自己的审美排好位置保存为serial_ui.ui文件。然后通过 PySide 自带的转换工具把它转成.pypyuic5 -x serial_ui.ui -o serial_ui.py这个命令把 UI 文件转成 Python 类-x参数是让生成的代码可以直接运行预览效果。转完之后可以看到一个名为Ui_MainWindow的类里面包含了所有的控件和布局。2.2 纯代码方式直接焊界面如果你嫌 Qt Designer 转来转去太啰嗦手写界面也没有那么可怕。我用的是代码和 UI 文件结合的方式用 Qt Designer 画框架但事件绑定和逻辑处理全在自己的类里写这样界面和逻辑分离看起来清爽。不过有一说一对于初学者我还是推荐纯手写 UI。理由很简单串口工具界面不复杂手写反而让你对布局和信号槽逻辑更熟悉。我自己实盘的时候也是用的嵌套布局手写# 主布局上下两块 main_layout QVBoxLayout() main_layout.addLayout(serial_layout()) # 顶部串口配置区 main_layout.addLayout(data_layout()) # 底部数据展示区这种思路下每个区域用一个函数单独返回布局代码结构清晰后期加组件也不容易乱。2.3 端口与波特率下拉框的坑界面里最常用的是 QComboBox但这里有一个非常经典的坑在 PyQt5 中当你想动态刷新串口列表时如果直接对 QComboBox 调用clear()和addItem()在某些情况下会导致界面卡顿甚至闪退。特别是当你把刷新逻辑放在一个定时器里频繁执行时踩中这个坑的概率很大。这部分我在第4节详细讲。先记住一个原则不要在定时器回调里频繁 clear QComboBox正确做法是每次刷新前先断开信号清空完毕后再重新连接信号或者用一个状态标记只有端口列表真的变化时才执行 clear 操作。3. 核心代码实现串口的打开、读取与实时数据显示界面骨架搭好了接下来是核心逻辑。串口工具的本质其实就三件事打开串口、读数据、显示数据。但每件事都有不少细节。3.1 串口配置类与打开操作我写了一个 SerialThread 类专门处理串口操作用 QThread 子类而不是在 GUI 线程里直接读串口。这样做的原因很直观串口读取是阻塞操作放在 GUI 主线程里会导致界面在读取期间完全卡死鼠标都拖不动。用独立线程的好处是界面始终流畅数据通过 Qt 信号传递回主线程更新 UI。import serial import serial.tools.list_ports from PyQt5.QtCore import QThread, pyqtSignal class SerialThread(QThread): data_received pyqtSignal(bytes) error_occurred pyqtSignal(str) def __init__(self): super().__init__() self.ser None self.running False def open_port(self, port, baudrate, bytesize, stopbits, parity): try: self.ser serial.Serial( portport, baudrateint(baudrate), bytesizebytesize, stopbitsstopbits, parityparity, timeout0.1 ) self.running True self.start() return True except Exception as e: self.error_occurred.emit(str(e)) return False def run(self): while self.running: if self.ser and self.ser.is_open: try: data self.ser.read(self.ser.in_waiting or 1) if data: self.data_received.emit(data) except Exception as e: self.error_occurred.emit(str(e)) self.running False break else: self.msleep(10) def send_data(self, data): if self.ser and self.ser.is_open: self.ser.write(data.encode(utf-8)) def close_port(self): self.running False if self.ser and self.ser.is_open: self.ser.close()几个关键点拆开来讲第一timeout0.1这个参数很关键。它决定了read()在没有数据时最多阻塞多久后返回。如果不设 timeout线程会被卡死在 read 上关闭串口时死等不到退出。设成 0.1 秒后每次最多等 100 毫秒既不会让 CPU 空转也保证了关闭串口时能及时退出循环。第二read(self.ser.in_waiting or 1)这个写法in_waiting是串口缓冲区里已经接收到的字节数。or 1是防止 in_waiting 为 0 时 read 直接返回空数据导致空转。先读已有数据没有就等 1 字节效率比较高。第三注意线程的退出方式。close_port先把 running 置 False再关闭串口。如果先关串口可能引发 read 异常。这个顺序建议严格按照现在的写。3.2 串口参数枚举的正确姿势端口号、波特率、数据位这些下拉框的填充不是随便写死的。端口号要动态枚举波特率一般给固定候选值但也可以手动输入。def refresh_ports(self): self.port_combo.blockSignals(True) old_port self.port_combo.currentText() if self.port_combo.count(): # 只有当端口数量或名字变化时才刷新避免闪退 pass self.port_combo.clear() for port in serial.tools.list_ports.comports(): self.port_combo.addItem(port.device) # 恢复之前的选中项 index self.port_combo.findText(old_port) if index 0: self.port_combo.setCurrentIndex(index) self.port_combo.blockSignals(False)blockSignals(True)很关键在清空和重新填充下拉框期间屏蔽所有信号防止因为信号触发二次清空引起崩溃。这也是网上搜“pyqt5 下拉框闪退”最常见的解决方案之一。3.3 主窗口逻辑类把数据和界面联动起来当 UI 的代码生成好了我们在主窗口类里继承并添加槽函数。主窗口类需要实现刷新端口列表打开/关闭串口按钮的状态切换接收数据信号的处理显示二进制或文本内容发送区数据发送核心段如下class MainWindow(QtWidgets.QMainWindow, serial_ui.Ui_MainWindow): def __init__(self): super().__init__() self.setupUi(self) self.serial_thread SerialThread() # 连接信号 self.serial_thread.data_received.connect(self.handle_data) self.serial_thread.error_occurred.connect(self.show_error) def handle_data(self, data): # 文本显示假设数据是ASCII/UTF-8 text data.decode(utf-8, errorsreplace) self.receive_textedit.insertPlainText(text) # 自动滚动到底部 self.receive_textedit.verticalScrollBar().setValue( self.receive_textedit.verticalScrollBar().maximum() ) # 这里可以接一个解析函数提取出数值用于曲线显示或标签显示 self.parse_and_display(data)自动滚动到底部是个很小的动作但没有它你会发现接收数据多了以后界面还停在第几屏得手动往下拖体验很差。这个细节建议加上。3.4 数据解析从原始字节到可读数值很多设备协议是自定义帧格式比如帧头 数据 校验例如AA 55 01 02 03 04。我习惯在串口线程里不对数据做过多的预处理什么脏数据都往界面上发然后在上层的解析函数里用状态机逐字节处理确认真实帧后再提取有效数据。一个通用的解析示例def parse_data(self, byte_data): # 假设协议AA 55 长度 数据... 校验 for b in byte_data: if self.parse_state 0: if b 0xAA: self.parse_state 1 elif self.parse_state 1: if b 0x55: self.parse_state 2 else: self.parse_state 0 elif self.parse_state 2: self.expected_len int(b) self.frame_buffer bytearray() self.frame_buffer.append(0xAA) self.frame_buffer.append(0x55) self.frame_buffer.append(b) self.parse_state 3 elif self.parse_state 3: self.frame_buffer.append(b) if len(self.frame_buffer) self.expected_len 3: # 校验通过就处理 self.process_frame(self.frame_buffer) self.parse_state 0这是很典型的“空状态机”写法。状态判断的分散处理比一上来就用正则或切片强得多因为串口数据是流式的一帧数据可能在两次读取里才到全必须逐字节积累状态。3.5 多数据可视化从数字标签到实时曲线如果你的场景是读取传感器数值那文本显示远远不够最能让人直观看到变化的就是折线图或者数字标签。PyQt5 里画曲线可以借助 pyqtgraph这个库绘图性能强专门为实时数据设计。pip install pyqtgraph在原有界面上加一个绘图区域import pyqtgraph as pg self.plot_widget pg.PlotWidget() self.curve self.plot_widget.plot(peny) self.data_buffer [] def update_plot(self, value): self.data_buffer.append(value) if len(self.data_buffer) 100: # 最多保存100个点 self.data_buffer.pop(0) self.curve.setData(self.data_buffer)把读取到的数值解析出来之后喂给update_plot方法曲线就会实时刷新。这里注意pyqtgraph 的 setData 不会自动清空画布它只是覆盖数据所以性能上完全扛得住 100Hz 的数据刷新。4. 踩坑实录常用的几个问题排查链路这个项目做完我踩的坑没有五个也有四个其中几个非常有代表性排查链路写出来至少能帮你省半天时间。4.1 下拉框闪退根因与解决网上一搜 pyqt5 下拉框闪退能找到一大片讨论我遇到的场景是在定时器里每 2 秒调用一次refresh_ports()。刚开始用的代码是self.port_combo.clear() self.port_combo.addItem(...)没有断开信号结果程序经常在一两分钟后闪退没有任何报错信息。排查链路是这样的先在refresh_ports入口处打日志发现闪退前日志并没有走完整个函数说明闪退发生在 clear 或者 addItem 内部。然后我直接注释掉 clear 行程序稳定注释掉 addItem程序也稳定两个都保留偶尔闪退。仔细翻 Qt 文档QComboBox 在清空当前项目后会触发 currentIndexChanged 信号如果连接到某个槽函数里又调用了清空或者插入操作就可能引发迭代器失效和内存访问冲突。最简单的解法是像前面代码里那样在清空前调用 blockSignals(True)全部操作完后再 blockSignals(False)让这个锁住信号的窗口期把重绘、信号全部挡在外面。另外还有个辅助方案只在端口列表变化时才做刷新我写了个简单比较new_ports [p.device for p in serial.tools.list_ports.comports()] old_ports [self.port_combo.itemText(i) for i in range(self.port_combo.count())] if new_ports ! old_ports: self.port_combo.blockSignals(True) self.port_combo.clear() ... self.port_combo.blockSignals(False)这种写法能极大降低 clear 的频率从根上减少闪退机会。4.2 串口端口列表刷新不出来设备另一个很常见的是插上设备后下拉框里什么都没有。排查链路从设备管理器开始如果设备管理器能看到 COM 口那就先跑python -m serial.tools.list_ports如果这里能看到但程序里刷新不到多半是 PySerial 版本太老。升级 pyserial 到最新版刷新函数改成serial.tools.list_ports.comports()而不是已经废弃的serial.tools.list_ports.ListPortInfo遍历方式。如果操作系统是 Windows还有一种特殊情形你插着设备的时候运行的 PyCharm但设备是启动后才插入的旧的端口缓存不会自动更新。这时候拔插一下 USB 或者重启程序基本都能解决。4.3 接收数据丢行和乱码的问题Linux 下串口接收丢数据是个老话题很多人在用read()时速度太快、读太慢就会丢。遇到这种情况先确认硬件流控对不对。如果设备不支持硬件流控但你在打开串口时设了rtsctsTrue那么数据会被强制流控截断表现为间歇性丢包。PySerial 默认参数是关闭硬件流控的建议不要乱开。如果开启过代码里重置参数ser serial.Serial() ser.rtscts False ser.dsrdtr False乱码问题则要先区分是软件解析问题还是参数不匹配。先看波特率、数据位、停止位和校验位是否跟设备一致这些参数有一个不对收到的就是乱码或错位数据。再用十六进制显示功能来看原始字节确认从串口发出来的本来就包含非文本字节。比如设备可能同时发送二进制协议和调试文本你需要用binascii.hexlify(data).decode()来显示 HEX 格式。4.4 关闭串口时程序卡死用 PySerial 的 read 阻塞在子线程里时如果你在主线程直接把串口 close 掉有时子线程没有被唤醒它卡在阻塞 read 里退出循环失败整个程序关不掉。我的解法就是之前强调的 timeout 机制self.ser serial.Serial(..., timeout0.1)timeout 设为 0.1 秒后read 最多阻塞 100 毫秒就返回即使没有数据也能回到 while 循环里检查 running 状态。关闭流程就变成先把self.runningFalse再self.close_port()关掉瞬时句柄子线程读到 timeout 后下一次循环判断 running 为 False 就退出最后通过 wait() 等待线程结束。5. 完整代码整合从串口线程到主窗口的一体化实现把我上面零散的代码拼起来组成一个可以直接跑起来的最小完整工程。下面给出核心文件代码UI 部分我直接用纯代码方式构建不依赖 UI 文件方便新手复制粘贴。import sys import serial import serial.tools.list_ports from PyQt5.QtCore import QThread, pyqtSignal from PyQt5.QtWidgets import (QApplication, QMainWindow, QWidget, QLabel, QComboBox, QPushButton, QTextEdit, QLineEdit, QVBoxLayout, QHBoxLayout, QGroupBox, QGridLayout) class SerialThread(QThread): data_received pyqtSignal(bytes) error_occurred pyqtSignal(str) def __init__(self): super().__init__() self.ser None self.running False def open_port(self, port, baudrate, bytesize8, stopbits1, parityN): try: self.ser serial.Serial( portport, baudratebaudrate, bytesizebytesize, stopbitsstopbits, parityparity, timeout0.1 ) self.running True self.start() return True except Exception as e: self.error_occurred.emit(str(e)) return False def run(self): while self.running: if self.ser and self.ser.is_open: try: wait_len self.ser.in_waiting or 1 data self.ser.read(wait_len) if data: self.data_received.emit(data) except Exception as e: self.error_occurred.emit(str(e)) self.running False break else: self.msleep(10) self.ser None def send_data(self, text): if self.ser and self.ser.is_open: self.ser.write(text.encode(utf-8)) def close_port(self): self.running False if self.ser and self.ser.is_open: try: self.ser.close() except Exception: pass self.wait(200) class MainWindow(QMainWindow): def __init__(self): super().__init__() self.setWindowTitle(PyQt5 串口调试助手) self.setMinimumSize(700, 500) self.serial_thread SerialThread() self.serial_thread.data_received.connect(self.handle_data) self.serial_thread.error_occurred.connect(self.show_error) self.build_ui() self.serial_port_combo.currentIndexChanged.connect(self.on_port_changed) def build_ui(self): central QWidget() self.setCentralWidget(central) outer_layout QVBoxLayout(central) # 顶部的串口配置区域 config_box QGroupBox(串口配置) grid QGridLayout() grid.addWidget(QLabel(串口), 0, 0) self.serial_port_combo QComboBox() self.serial_port_combo.setMinimumWidth(120) grid.addWidget(self.serial_port_combo, 0, 1) grid.addWidget(QLabel(波特率), 0, 2) self.baudrate_combo QComboBox() self.baudrate_combo.addItems([9600, 19200, 38400, 57600, 115200, 230400]) self.baudrate_combo.setCurrentText(115200) grid.addWidget(self.baudrate_combo, 0, 3) self.refresh_btn QPushButton(刷新串口) grid.addWidget(self.refresh_btn, 0, 4) self.open_btn QPushButton(打开串口) grid.addWidget(self.open_btn, 0, 5) config_box.setLayout(grid) outer_layout.addWidget(config_box) # 接收显示区域 receive_box QGroupBox(接收数据) receive_layout QVBoxLayout() self.receive_textedit QTextEdit() self.receive_textedit.setReadOnly(True) receive_layout.addWidget(self.receive_textedit) receive_box.setLayout(receive_layout) outer_layout.addWidget(receive_box) # 发送区域直接用水平布局放一行控件 send_layout QHBoxLayout() self.send_lineedit QLineEdit() send_layout.addWidget(self.send_lineedit) self.send_btn QPushButton(发送) send_layout.addWidget(self.send_btn) outer_layout.addLayout(send_layout) # 事件绑定 self.refresh_btn.clicked.connect(self.refresh_ports) self.open_btn.clicked.connect(self.toggle_port) self.send_btn.clicked.connect(self.send_data) self.refresh_ports() def refresh_ports(self): ports [p.device for p in serial.tools.list_ports.comports()] if not ports: ports [COM1, COM2] # 没有检测到设备时给个占位 self.serial_port_combo.clear() self.serial_port_combo.addItems(ports) def toggle_port(self): if self.open_btn.text() 打开串口: port self.serial_port_combo.currentText() baud int(self.baudrate_combo.currentText()) ok self.serial_thread.open_port(port, baud) if ok: self.open_btn.setText(关闭串口) else: self.receive_textedit.append(打开失败请检查串口) else: self.serial_thread.close_port() self.open_btn.setText(打开串口) def handle_data(self, data): text data.decode(utf-8, errorsreplace) self.receive_textedit.insertPlainText(text) sb self.receive_textedit.verticalScrollBar() sb.setValue(sb.maximum()) def send_data(self): text self.send_lineedit.text() if text: self.serial_thread.send_data(text) def show_error(self, msg): self.receive_textedit.append(f[错误] {msg}) def on_port_changed(self, _index): pass if __name__ __main__: app QApplication(sys.argv) win MainWindow() win.show() sys.exit(app.exec_())这段代码可以直接存成serial_tool.py跑起来。界面虽然朴素但已经具备了一个串口调试助手的核心功能端口选择、波特率设置、打开/关闭串口、接收数据实时显示、发送字符串数据。6. 进阶功能扩展超链接文本、Hex显示与自动重连基础版跑通之后很多人会按自己的需求加功能。我在这篇文章里最开始看到热搜词里有“pyqt5 文本框超链接点击后执行自定义操作”和“pyqt5 显示html”这两个其实是在做日志或者协议说明时的常见需求这里一起扩展讲一下。6.1 QTextEdit 中显示超链接并响应点击如果你要在接收区显示带超链接的内容比如设备返回了一个文件路径或者网页地址点击后要执行自定义操作比如用系统浏览器打开或复制到剪贴板。默认情况下 QTextEdit 里的超链接只显示不响应点击。要让它响应需要做两件事self.receive_textedit.setOpenExternalLinks(False) self.receive_textedit.setReadOnly(True) # 使用 anchorClicked 信号 self.receive_textedit.anchorClicked.connect(self.link_clicked) def link_clicked(self, url): # url 是 QUrl if url.scheme() http: import webbrowser webbrowser.open(url.toString()) else: print(自定义操作, url.toString())注意在插入 HTML 内容时用insertHtml()而不是insertPlainText()。如果混用格式化会乱掉。实际项目中我一般只在专门显示报告的标签页里用富文本接收原始数据那里永远是纯文本模式避免代码串味。6.2 Hex 显示实现调试二进制协议时纯文本显示会看到一堆乱码必须切换成十六进制视图。在接收显示函数中加个判断if self.hex_checkbox.isChecked(): hex_str data.hex().upper() for i in range(0, len(hex_str), 2): self.receive_textedit.insertPlainText(hex_str[i:i2] ) self.receive_textedit.insertPlainText(\n) else: self.receive_textedit.insertPlainText(data.decode(utf-8, errorsreplace))接口上放置一个 QCheckBox 勾选“Hex 显示”通过判断来自动切换非常实用。6.3 自动重连与异常恢复开放的设备偶尔会掉线或者被拔出再插入为了让工具更智能可以加一个超时重连机制。比如每 3 秒检查一次串口状态如果发现串口对象不存在或未打开但设备列表中有对应设备就尝试重新打开。def check_and_reconnect(self): if self.serial_thread.running: return port self.serial_port_combo.currentText() if port and port in [p.device for p in serial.tools.list_ports.comports()]: self.serial_thread.open_port(port, int(self.baudrate_combo.currentText())) self.open_btn.setText(关闭串口)用 QTimer 每 3000 毫秒调用一次这个方法用户体验会好很多。但注意设置一个最大重试次数比如连续重试 5 次还失败就停止否则设备真的没插好时程序会疯狂重连。6.4 数据保存到文件接收到的数据如果要落盘最基础的是在 handle_data 里直接追加写文件。但直接同步写文件会影响 UI 性能建议用一个简单的 buffer 列表每积攒一定字节数再批量写入self.write_buffer [] def save_to_file(self, data): self.write_buffer.append(data) if len(self.write_buffer) * len(data) 4096: with open(self.save_path, ab) as f: f.writelines(self.write_buffer) self.write_buffer.clear()注意是二进制模式打开保留原始字节不要用 text 模式否则某些字节会被编码转换搞坏。7. 实测表现与调优建议我这个工具实测连接一个以 100Hz 频率发送 20 字节数据帧的设备界面刷新完全流畅CPU 占用大概在 8% 到 15% 之间主要开销在 QTextEdit 的文本插入和 QComboBox 的偶尔刷新上。如果接收频率再高每秒几千条数据QTextEdit 会逐渐变慢。这时候有两个优化方向把文本区限制显示行数比如超过 5000 行就删除前半部分用 QTextEdit 的document().setMaximumBlockCount(5000)这是最简单的一招。把数据曲线显示放到独立的 pyqtgraph 控件里文本区只做必要的日志记录从根本上减少文本渲染负担。另一个调优重点是串口线程的休眠策略。msleep(10)配合 timeout0.1在读不到数据时最多循环 100 次/秒但实际没有数据时 read 会等满 100ms 才返回所以真正空闲时线程的唤醒次数在 10 次/秒左右这样 CPU 很省也不会出现响应迟钝。之前在 Linux 上遇到的接收丢数据问题最后是控制线程在每次 read 之后不做多余处理快速回到 read同时保证应用层处理逻辑不阻塞才彻底稳定。这也是把数据解析放在主线程、而读取放在子线程的重要原因——读取线程越轻量越不容易丢数据。8. 写在最后的一点个人经验搭建这套串口工具的过程中我最深刻的体会是串口调试助手看起来简单但真正要做好难点根本不在串口本身而在于 PyQt 的信号机制、线程模型和控件生命周期管理。一旦把数据读取放到独立线程、把 UI 刷新通过信号传递回主线程这个架构想明白剩下的一切都是填代码了。建议你拿到这篇文章里的代码后不要急着加功能先跑通一个最简版本能打开串口、能显示数据。然后再逐步加 Hex 显示、曲线绘制、文件保存。功能加得越多出问题的概率越大基础不牢的话后面排查会很难受。最后再多说一句如果遇到奇怪的崩溃优先怀疑 QComboBox 的信号重入其次怀疑线程退出时机不对。这两个问题覆盖了我在 PyQt5 串口工具上 80% 的翻车现场文章里也都给出了对应的解法。祝你跑通顺利也欢迎交流更多串口上位机的玩法。本文还有配套的精品资源点击获取 
简介这是一份采用Python与PyQt5编写的串口读取与显示小程序源码面向Python初学者、单片机开发者和需要快速搭建上位机的学生解决了从串口接收数据、将数据写入SQLite数据库以及通过UI界面动态显示这三类常见问题。压缩包总计14个文件体积仅16KB核心是两个py脚本一个负责界面逻辑另一个负责数据处理与数据库操作其余7个xml配置、3个meta文件及IML文件主要用于PyCharm工程结构识别pyc文件则是运行时生成的缓存。该资源已有7055人学习代码量虽小但完整覆盖了串口初始化、接收解析、数据入库和列表/控件刷新等必要环节并配有db数据目录和工程配置文件可直接导入PyCharm观察效果。阅读源码后可以清楚对比PyQt5信号槽调用、sqlite3写入事务和串口库read/readline的配合方式非常适合作为课程设计、毕业设计或嵌入式调试工具开发的参考模板。 直接开始。写这篇东西的起因挺简单我手头有个传感器模块需要用上位机把串口发回来的数据实时画成曲线本来想找个现成的串口调试助手凑合用结果要么功能太重要么界面难看要么就是收数没问题但显示只能看文本。折腾一圈之后我决定自己用 PyCharm PyQt5 写一个前前后后花了两个晚上把串口读取、数据显示、界面刷新这条路全走通了。这篇文章就把完整实现过程、关键代码和踩过的坑都整理出来给同样想自己做串口上位机的朋友一条能直接抄的路。先说清楚这玩意儿能干什么通过 PyQt5 的串口模块接收设备发来的数据在界面上实时显示原始文本和解析后的数值还能把接收到的数据保存到本地文件。适合所有需要快速搭建串口调试工具的场景不管你是调试 STM32、Arduino还是跟各种传感器模块打交道这套代码都能直接用。你不需要太深的 PyQt 基础跟着步骤走就行。1. 环境准备PyCharm 里把 PyQt5 和串口库一次装好动手写代码之前先把环境搞定。工欲善其事必先利其器在 PyQt5 串口这条路上最容易翻车的就是环境配置阶段。1.1 Python 解释器和虚拟环境的坑我用的 PyCharm 是社区版免费的就够用专业版的功能在普通串口调试场景里用不上。Python 版本建议 3.8 到 3.11 之间别用最新的 3.12因为部分 PyQt5 的依赖库可能还没完全适配实测 3.12 跑 PyQt5 偶尔会报 Qt 平台插件相关的错折腾起来比较浪费时间。打开 PyCharm 新建项目时建议勾选“New environment using Virtualenv”让每个项目单独拥有一套依赖环境。很多新手图省事直接删掉虚拟环境装到全局 Python 里结果不同项目之间依赖冲突串口库版本互相污染后期排查很痛苦。虚拟环境这个习惯值得养成。1.2 PyQt5 与串口库的安装依赖安装直接用 pip在 PyCharm 底部的 Terminal 里执行pip install PyQt5 pyqt5-tools pyserial这里我解释一下三个包的各自职责别装完就忘PyQt5界面框架负责窗口、按钮、文本框、布局这些 UI 组件。pyqt5-tools包含了 Qt Designer 可视化设计工具虽然不是必须但用它拖界面比自己纯手敲代码快很多推荐装。pyserial独立的串口操作库PyQt5 本身不直接提供串口功能需要借助 pyserial 或 PyQt5 自带的 QtSerialPort。这里我用 pyserial因为它在跨平台方面更稳定代码也更直观。测试安装是否成功在终端里执行from PyQt5.QtWidgets import QApplication import serial print(OK)只要不报错环境就通了。如果这里报 ModuleNotFoundError先检查是不是虚拟环境没有激活或者 PyCharm 的项目解释器没切到虚拟环境。1.3 串口驱动别让设备悄悄失踪如果你的设备是 USB 转串口比如常见的 CH340、FTDI、CP2102 这些芯片系统没装驱动的话PySerial 里根本看不到对应端口。Windows 下连接设备后在“设备管理器”的“端口COM 和 LPT”里检查如果显示黄色感叹号就是驱动问题。CH340 的驱动需要从官网或厂商页面下载FTDI 的驱动通常 Windows 10 以上系统会自动安装。装完驱动后务必重启 PyCharm 或者重新插拔设备否则端口列表不会刷新。另外检查端口是否可用可以用下面的小命令python -m serial.tools.list_ports这个命令会列出所有可用的 COM 端口有个端口列表的显示帮你确认设备是否正常连接。2. 界面设计用最简单的方式搭出串口调试工具我建议先用 Qt Designer 直接把界面样子拖出来省时省力再转成 Python 代码。当然如果你对代码熟也可以直接纯手写。这里两种方式都说一下因为不同的人习惯不同。2.1 Qt Designer 可视化拖拽布局启动 Qt Designer 的方式是在终端执行pyqt5-tools designer会弹出可视化的窗体设计工具。新建一个 Main Window从左边控件面板拖入以下内容左侧串口配置区域放几个 QLabel 和 QComboBox分别用于端口选择、波特率选择、数据位、停止位、校验位再加一个“打开串口”按钮。中间接收数据区域放一个 QTextEdit设置为只读用于显示原始文本下面放一个 QLineEdit 和一个“发送”按钮用于发送数据。右侧或底部数据显示区域放一个 QLabel 来动态显示解析后的数值或者干脆用一个 QPlainTextEdit。按照自己的审美排好位置保存为serial_ui.ui文件。然后通过 PySide 自带的转换工具把它转成.pypyuic5 -x serial_ui.ui -o serial_ui.py这个命令把 UI 文件转成 Python 类-x参数是让生成的代码可以直接运行预览效果。转完之后可以看到一个名为Ui_MainWindow的类里面包含了所有的控件和布局。2.2 纯代码方式直接焊界面如果你嫌 Qt Designer 转来转去太啰嗦手写界面也没有那么可怕。我用的是代码和 UI 文件结合的方式用 Qt Designer 画框架但事件绑定和逻辑处理全在自己的类里写这样界面和逻辑分离看起来清爽。不过有一说一对于初学者我还是推荐纯手写 UI。理由很简单串口工具界面不复杂手写反而让你对布局和信号槽逻辑更熟悉。我自己实盘的时候也是用的嵌套布局手写# 主布局上下两块 main_layout QVBoxLayout() main_layout.addLayout(serial_layout()) # 顶部串口配置区 main_layout.addLayout(data_layout()) # 底部数据展示区这种思路下每个区域用一个函数单独返回布局代码结构清晰后期加组件也不容易乱。2.3 端口与波特率下拉框的坑界面里最常用的是 QComboBox但这里有一个非常经典的坑在 PyQt5 中当你想动态刷新串口列表时如果直接对 QComboBox 调用clear()和addItem()在某些情况下会导致界面卡顿甚至闪退。特别是当你把刷新逻辑放在一个定时器里频繁执行时踩中这个坑的概率很大。这部分我在第4节详细讲。先记住一个原则不要在定时器回调里频繁 clear QComboBox正确做法是每次刷新前先断开信号清空完毕后再重新连接信号或者用一个状态标记只有端口列表真的变化时才执行 clear 操作。3. 核心代码实现串口的打开、读取与实时数据显示界面骨架搭好了接下来是核心逻辑。串口工具的本质其实就三件事打开串口、读数据、显示数据。但每件事都有不少细节。3.1 串口配置类与打开操作我写了一个 SerialThread 类专门处理串口操作用 QThread 子类而不是在 GUI 线程里直接读串口。这样做的原因很直观串口读取是阻塞操作放在 GUI 主线程里会导致界面在读取期间完全卡死鼠标都拖不动。用独立线程的好处是界面始终流畅数据通过 Qt 信号传递回主线程更新 UI。import serial import serial.tools.list_ports from PyQt5.QtCore import QThread, pyqtSignal class SerialThread(QThread): data_received pyqtSignal(bytes) error_occurred pyqtSignal(str) def __init__(self): super().__init__() self.ser None self.running False def open_port(self, port, baudrate, bytesize, stopbits, parity): try: self.ser serial.Serial( portport, baudrateint(baudrate), bytesizebytesize, stopbitsstopbits, parityparity, timeout0.1 ) self.running True self.start() return True except Exception as e: self.error_occurred.emit(str(e)) return False def run(self): while self.running: if self.ser and self.ser.is_open: try: data self.ser.read(self.ser.in_waiting or 1) if data: self.data_received.emit(data) except Exception as e: self.error_occurred.emit(str(e)) self.running False break else: self.msleep(10) def send_data(self, data): if self.ser and self.ser.is_open: self.ser.write(data.encode(utf-8)) def close_port(self): self.running False if self.ser and self.ser.is_open: self.ser.close()几个关键点拆开来讲第一timeout0.1这个参数很关键。它决定了read()在没有数据时最多阻塞多久后返回。如果不设 timeout线程会被卡死在 read 上关闭串口时死等不到退出。设成 0.1 秒后每次最多等 100 毫秒既不会让 CPU 空转也保证了关闭串口时能及时退出循环。第二read(self.ser.in_waiting or 1)这个写法in_waiting是串口缓冲区里已经接收到的字节数。or 1是防止 in_waiting 为 0 时 read 直接返回空数据导致空转。先读已有数据没有就等 1 字节效率比较高。第三注意线程的退出方式。close_port先把 running 置 False再关闭串口。如果先关串口可能引发 read 异常。这个顺序建议严格按照现在的写。3.2 串口参数枚举的正确姿势端口号、波特率、数据位这些下拉框的填充不是随便写死的。端口号要动态枚举波特率一般给固定候选值但也可以手动输入。def refresh_ports(self): self.port_combo.blockSignals(True) old_port self.port_combo.currentText() if self.port_combo.count(): # 只有当端口数量或名字变化时才刷新避免闪退 pass self.port_combo.clear() for port in serial.tools.list_ports.comports(): self.port_combo.addItem(port.device) # 恢复之前的选中项 index self.port_combo.findText(old_port) if index 0: self.port_combo.setCurrentIndex(index) self.port_combo.blockSignals(False)blockSignals(True)很关键在清空和重新填充下拉框期间屏蔽所有信号防止因为信号触发二次清空引起崩溃。这也是网上搜“pyqt5 下拉框闪退”最常见的解决方案之一。3.3 主窗口逻辑类把数据和界面联动起来当 UI 的代码生成好了我们在主窗口类里继承并添加槽函数。主窗口类需要实现刷新端口列表打开/关闭串口按钮的状态切换接收数据信号的处理显示二进制或文本内容发送区数据发送核心段如下class MainWindow(QtWidgets.QMainWindow, serial_ui.Ui_MainWindow): def __init__(self): super().__init__() self.setupUi(self) self.serial_thread SerialThread() # 连接信号 self.serial_thread.data_received.connect(self.handle_data) self.serial_thread.error_occurred.connect(self.show_error) def handle_data(self, data): # 文本显示假设数据是ASCII/UTF-8 text data.decode(utf-8, errorsreplace) self.receive_textedit.insertPlainText(text) # 自动滚动到底部 self.receive_textedit.verticalScrollBar().setValue( self.receive_textedit.verticalScrollBar().maximum() ) # 这里可以接一个解析函数提取出数值用于曲线显示或标签显示 self.parse_and_display(data)自动滚动到底部是个很小的动作但没有它你会发现接收数据多了以后界面还停在第几屏得手动往下拖体验很差。这个细节建议加上。3.4 数据解析从原始字节到可读数值很多设备协议是自定义帧格式比如帧头 数据 校验例如AA 55 01 02 03 04。我习惯在串口线程里不对数据做过多的预处理什么脏数据都往界面上发然后在上层的解析函数里用状态机逐字节处理确认真实帧后再提取有效数据。一个通用的解析示例def parse_data(self, byte_data): # 假设协议AA 55 长度 数据... 校验 for b in byte_data: if self.parse_state 0: if b 0xAA: self.parse_state 1 elif self.parse_state 1: if b 0x55: self.parse_state 2 else: self.parse_state 0 elif self.parse_state 2: self.expected_len int(b) self.frame_buffer bytearray() self.frame_buffer.append(0xAA) self.frame_buffer.append(0x55) self.frame_buffer.append(b) self.parse_state 3 elif self.parse_state 3: self.frame_buffer.append(b) if len(self.frame_buffer) self.expected_len 3: # 校验通过就处理 self.process_frame(self.frame_buffer) self.parse_state 0这是很典型的“空状态机”写法。状态判断的分散处理比一上来就用正则或切片强得多因为串口数据是流式的一帧数据可能在两次读取里才到全必须逐字节积累状态。3.5 多数据可视化从数字标签到实时曲线如果你的场景是读取传感器数值那文本显示远远不够最能让人直观看到变化的就是折线图或者数字标签。PyQt5 里画曲线可以借助 pyqtgraph这个库绘图性能强专门为实时数据设计。pip install pyqtgraph在原有界面上加一个绘图区域import pyqtgraph as pg self.plot_widget pg.PlotWidget() self.curve self.plot_widget.plot(peny) self.data_buffer [] def update_plot(self, value): self.data_buffer.append(value) if len(self.data_buffer) 100: # 最多保存100个点 self.data_buffer.pop(0) self.curve.setData(self.data_buffer)把读取到的数值解析出来之后喂给update_plot方法曲线就会实时刷新。这里注意pyqtgraph 的 setData 不会自动清空画布它只是覆盖数据所以性能上完全扛得住 100Hz 的数据刷新。4. 踩坑实录常用的几个问题排查链路这个项目做完我踩的坑没有五个也有四个其中几个非常有代表性排查链路写出来至少能帮你省半天时间。4.1 下拉框闪退根因与解决网上一搜 pyqt5 下拉框闪退能找到一大片讨论我遇到的场景是在定时器里每 2 秒调用一次refresh_ports()。刚开始用的代码是self.port_combo.clear() self.port_combo.addItem(...)没有断开信号结果程序经常在一两分钟后闪退没有任何报错信息。排查链路是这样的先在refresh_ports入口处打日志发现闪退前日志并没有走完整个函数说明闪退发生在 clear 或者 addItem 内部。然后我直接注释掉 clear 行程序稳定注释掉 addItem程序也稳定两个都保留偶尔闪退。仔细翻 Qt 文档QComboBox 在清空当前项目后会触发 currentIndexChanged 信号如果连接到某个槽函数里又调用了清空或者插入操作就可能引发迭代器失效和内存访问冲突。最简单的解法是像前面代码里那样在清空前调用 blockSignals(True)全部操作完后再 blockSignals(False)让这个锁住信号的窗口期把重绘、信号全部挡在外面。另外还有个辅助方案只在端口列表变化时才做刷新我写了个简单比较new_ports [p.device for p in serial.tools.list_ports.comports()] old_ports [self.port_combo.itemText(i) for i in range(self.port_combo.count())] if new_ports ! old_ports: self.port_combo.blockSignals(True) self.port_combo.clear() ... self.port_combo.blockSignals(False)这种写法能极大降低 clear 的频率从根上减少闪退机会。4.2 串口端口列表刷新不出来设备另一个很常见的是插上设备后下拉框里什么都没有。排查链路从设备管理器开始如果设备管理器能看到 COM 口那就先跑python -m serial.tools.list_ports如果这里能看到但程序里刷新不到多半是 PySerial 版本太老。升级 pyserial 到最新版刷新函数改成serial.tools.list_ports.comports()而不是已经废弃的serial.tools.list_ports.ListPortInfo遍历方式。如果操作系统是 Windows还有一种特殊情形你插着设备的时候运行的 PyCharm但设备是启动后才插入的旧的端口缓存不会自动更新。这时候拔插一下 USB 或者重启程序基本都能解决。4.3 接收数据丢行和乱码的问题Linux 下串口接收丢数据是个老话题很多人在用read()时速度太快、读太慢就会丢。遇到这种情况先确认硬件流控对不对。如果设备不支持硬件流控但你在打开串口时设了rtsctsTrue那么数据会被强制流控截断表现为间歇性丢包。PySerial 默认参数是关闭硬件流控的建议不要乱开。如果开启过代码里重置参数ser serial.Serial() ser.rtscts False ser.dsrdtr False乱码问题则要先区分是软件解析问题还是参数不匹配。先看波特率、数据位、停止位和校验位是否跟设备一致这些参数有一个不对收到的就是乱码或错位数据。再用十六进制显示功能来看原始字节确认从串口发出来的本来就包含非文本字节。比如设备可能同时发送二进制协议和调试文本你需要用binascii.hexlify(data).decode()来显示 HEX 格式。4.4 关闭串口时程序卡死用 PySerial 的 read 阻塞在子线程里时如果你在主线程直接把串口 close 掉有时子线程没有被唤醒它卡在阻塞 read 里退出循环失败整个程序关不掉。我的解法就是之前强调的 timeout 机制self.ser serial.Serial(..., timeout0.1)timeout 设为 0.1 秒后read 最多阻塞 100 毫秒就返回即使没有数据也能回到 while 循环里检查 running 状态。关闭流程就变成先把self.runningFalse再self.close_port()关掉瞬时句柄子线程读到 timeout 后下一次循环判断 running 为 False 就退出最后通过 wait() 等待线程结束。5. 完整代码整合从串口线程到主窗口的一体化实现把我上面零散的代码拼起来组成一个可以直接跑起来的最小完整工程。下面给出核心文件代码UI 部分我直接用纯代码方式构建不依赖 UI 文件方便新手复制粘贴。import sys import serial import serial.tools.list_ports from PyQt5.QtCore import QThread, pyqtSignal from PyQt5.QtWidgets import (QApplication, QMainWindow, QWidget, QLabel, QComboBox, QPushButton, QTextEdit, QLineEdit, QVBoxLayout, QHBoxLayout, QGroupBox, QGridLayout) class SerialThread(QThread): data_received pyqtSignal(bytes) error_occurred pyqtSignal(str) def __init__(self): super().__init__() self.ser None self.running False def open_port(self, port, baudrate, bytesize8, stopbits1, parityN): try: self.ser serial.Serial( portport, baudratebaudrate, bytesizebytesize, stopbitsstopbits, parityparity, timeout0.1 ) self.running True self.start() return True except Exception as e: self.error_occurred.emit(str(e)) return False def run(self): while self.running: if self.ser and self.ser.is_open: try: wait_len self.ser.in_waiting or 1 data self.ser.read(wait_len) if data: self.data_received.emit(data) except Exception as e: self.error_occurred.emit(str(e)) self.running False break else: self.msleep(10) self.ser None def send_data(self, text): if self.ser and self.ser.is_open: self.ser.write(text.encode(utf-8)) def close_port(self): self.running False if self.ser and self.ser.is_open: try: self.ser.close() except Exception: pass self.wait(200) class MainWindow(QMainWindow): def __init__(self): super().__init__() self.setWindowTitle(PyQt5 串口调试助手) self.setMinimumSize(700, 500) self.serial_thread SerialThread() self.serial_thread.data_received.connect(self.handle_data) self.serial_thread.error_occurred.connect(self.show_error) self.build_ui() self.serial_port_combo.currentIndexChanged.connect(self.on_port_changed) def build_ui(self): central QWidget() self.setCentralWidget(central) outer_layout QVBoxLayout(central) # 顶部的串口配置区域 config_box QGroupBox(串口配置) grid QGridLayout() grid.addWidget(QLabel(串口), 0, 0) self.serial_port_combo QComboBox() self.serial_port_combo.setMinimumWidth(120) grid.addWidget(self.serial_port_combo, 0, 1) grid.addWidget(QLabel(波特率), 0, 2) self.baudrate_combo QComboBox() self.baudrate_combo.addItems([9600, 19200, 38400, 57600, 115200, 230400]) self.baudrate_combo.setCurrentText(115200) grid.addWidget(self.baudrate_combo, 0, 3) self.refresh_btn QPushButton(刷新串口) grid.addWidget(self.refresh_btn, 0, 4) self.open_btn QPushButton(打开串口) grid.addWidget(self.open_btn, 0, 5) config_box.setLayout(grid) outer_layout.addWidget(config_box) # 接收显示区域 receive_box QGroupBox(接收数据) receive_layout QVBoxLayout() self.receive_textedit QTextEdit() self.receive_textedit.setReadOnly(True) receive_layout.addWidget(self.receive_textedit) receive_box.setLayout(receive_layout) outer_layout.addWidget(receive_box) # 发送区域直接用水平布局放一行控件 send_layout QHBoxLayout() self.send_lineedit QLineEdit() send_layout.addWidget(self.send_lineedit) self.send_btn QPushButton(发送) send_layout.addWidget(self.send_btn) outer_layout.addLayout(send_layout) # 事件绑定 self.refresh_btn.clicked.connect(self.refresh_ports) self.open_btn.clicked.connect(self.toggle_port) self.send_btn.clicked.connect(self.send_data) self.refresh_ports() def refresh_ports(self): ports [p.device for p in serial.tools.list_ports.comports()] if not ports: ports [COM1, COM2] # 没有检测到设备时给个占位 self.serial_port_combo.clear() self.serial_port_combo.addItems(ports) def toggle_port(self): if self.open_btn.text() 打开串口: port self.serial_port_combo.currentText() baud int(self.baudrate_combo.currentText()) ok self.serial_thread.open_port(port, baud) if ok: self.open_btn.setText(关闭串口) else: self.receive_textedit.append(打开失败请检查串口) else: self.serial_thread.close_port() self.open_btn.setText(打开串口) def handle_data(self, data): text data.decode(utf-8, errorsreplace) self.receive_textedit.insertPlainText(text) sb self.receive_textedit.verticalScrollBar() sb.setValue(sb.maximum()) def send_data(self): text self.send_lineedit.text() if text: self.serial_thread.send_data(text) def show_error(self, msg): self.receive_textedit.append(f[错误] {msg}) def on_port_changed(self, _index): pass if __name__ __main__: app QApplication(sys.argv) win MainWindow() win.show() sys.exit(app.exec_())这段代码可以直接存成serial_tool.py跑起来。界面虽然朴素但已经具备了一个串口调试助手的核心功能端口选择、波特率设置、打开/关闭串口、接收数据实时显示、发送字符串数据。6. 进阶功能扩展超链接文本、Hex显示与自动重连基础版跑通之后很多人会按自己的需求加功能。我在这篇文章里最开始看到热搜词里有“pyqt5 文本框超链接点击后执行自定义操作”和“pyqt5 显示html”这两个其实是在做日志或者协议说明时的常见需求这里一起扩展讲一下。6.1 QTextEdit 中显示超链接并响应点击如果你要在接收区显示带超链接的内容比如设备返回了一个文件路径或者网页地址点击后要执行自定义操作比如用系统浏览器打开或复制到剪贴板。默认情况下 QTextEdit 里的超链接只显示不响应点击。要让它响应需要做两件事self.receive_textedit.setOpenExternalLinks(False) self.receive_textedit.setReadOnly(True) # 使用 anchorClicked 信号 self.receive_textedit.anchorClicked.connect(self.link_clicked) def link_clicked(self, url): # url 是 QUrl if url.scheme() http: import webbrowser webbrowser.open(url.toString()) else: print(自定义操作, url.toString())注意在插入 HTML 内容时用insertHtml()而不是insertPlainText()。如果混用格式化会乱掉。实际项目中我一般只在专门显示报告的标签页里用富文本接收原始数据那里永远是纯文本模式避免代码串味。6.2 Hex 显示实现调试二进制协议时纯文本显示会看到一堆乱码必须切换成十六进制视图。在接收显示函数中加个判断if self.hex_checkbox.isChecked(): hex_str data.hex().upper() for i in range(0, len(hex_str), 2): self.receive_textedit.insertPlainText(hex_str[i:i2] ) self.receive_textedit.insertPlainText(\n) else: self.receive_textedit.insertPlainText(data.decode(utf-8, errorsreplace))接口上放置一个 QCheckBox 勾选“Hex 显示”通过判断来自动切换非常实用。6.3 自动重连与异常恢复开放的设备偶尔会掉线或者被拔出再插入为了让工具更智能可以加一个超时重连机制。比如每 3 秒检查一次串口状态如果发现串口对象不存在或未打开但设备列表中有对应设备就尝试重新打开。def check_and_reconnect(self): if self.serial_thread.running: return port self.serial_port_combo.currentText() if port and port in [p.device for p in serial.tools.list_ports.comports()]: self.serial_thread.open_port(port, int(self.baudrate_combo.currentText())) self.open_btn.setText(关闭串口)用 QTimer 每 3000 毫秒调用一次这个方法用户体验会好很多。但注意设置一个最大重试次数比如连续重试 5 次还失败就停止否则设备真的没插好时程序会疯狂重连。6.4 数据保存到文件接收到的数据如果要落盘最基础的是在 handle_data 里直接追加写文件。但直接同步写文件会影响 UI 性能建议用一个简单的 buffer 列表每积攒一定字节数再批量写入self.write_buffer [] def save_to_file(self, data): self.write_buffer.append(data) if len(self.write_buffer) * len(data) 4096: with open(self.save_path, ab) as f: f.writelines(self.write_buffer) self.write_buffer.clear()注意是二进制模式打开保留原始字节不要用 text 模式否则某些字节会被编码转换搞坏。7. 实测表现与调优建议我这个工具实测连接一个以 100Hz 频率发送 20 字节数据帧的设备界面刷新完全流畅CPU 占用大概在 8% 到 15% 之间主要开销在 QTextEdit 的文本插入和 QComboBox 的偶尔刷新上。如果接收频率再高每秒几千条数据QTextEdit 会逐渐变慢。这时候有两个优化方向把文本区限制显示行数比如超过 5000 行就删除前半部分用 QTextEdit 的document().setMaximumBlockCount(5000)这是最简单的一招。把数据曲线显示放到独立的 pyqtgraph 控件里文本区只做必要的日志记录从根本上减少文本渲染负担。另一个调优重点是串口线程的休眠策略。msleep(10)配合 timeout0.1在读不到数据时最多循环 100 次/秒但实际没有数据时 read 会等满 100ms 才返回所以真正空闲时线程的唤醒次数在 10 次/秒左右这样 CPU 很省也不会出现响应迟钝。之前在 Linux 上遇到的接收丢数据问题最后是控制线程在每次 read 之后不做多余处理快速回到 read同时保证应用层处理逻辑不阻塞才彻底稳定。这也是把数据解析放在主线程、而读取放在子线程的重要原因——读取线程越轻量越不容易丢数据。8. 写在最后的一点个人经验搭建这套串口工具的过程中我最深刻的体会是串口调试助手看起来简单但真正要做好难点根本不在串口本身而在于 PyQt 的信号机制、线程模型和控件生命周期管理。一旦把数据读取放到独立线程、把 UI 刷新通过信号传递回主线程这个架构想明白剩下的一切都是填代码了。建议你拿到这篇文章里的代码后不要急着加功能先跑通一个最简版本能打开串口、能显示数据。然后再逐步加 Hex 显示、曲线绘制、文件保存。功能加得越多出问题的概率越大基础不牢的话后面排查会很难受。最后再多说一句如果遇到奇怪的崩溃优先怀疑 QComboBox 的信号重入其次怀疑线程退出时机不对。这两个问题覆盖了我在 PyQt5 串口工具上 80% 的翻车现场文章里也都给出了对应的解法。祝你跑通顺利也欢迎交流更多串口上位机的玩法。本文还有配套的精品资源点击获取