零基础C++实战上位机--基于QT5.15的串口调试工具（一）
1. 为什么你需要自己开发串口调试工具
作为一个嵌入式开发者，我猜你一定遇到过这样的场景：单片机程序跑飞了，你急需要查看某个变量的实时数据；或者产品测试时，客户需要直观地看到传感器采集的数据。这时候，一个顺手好用的串口调试工具简直就是救命稻草。
市面上的串口助手确实不少，从老牌的串口猎人、XCOM到各种开源工具，选择很多。但用着用着就会发现，这些通用工具总有些地方不够顺手：界面太复杂、功能太多余、数据格式不支持...更别提那些突然崩溃丢失数据的糟心时刻。我遇到过最尴尬的情况是，在给客户演示时，串口助手突然卡死，场面一度十分尴尬。
自己开发串口工具的好处显而易见：
- 完全自定义：你可以设计最适合当前项目的界面布局
- 功能精准匹配：只保留需要的功能，去掉冗余选项
- 数据可视化：针对特定数据类型做定制化显示
- 稳定性可控：自己写的代码，出问题知道怎么修
更重要的是，这其实是个绝佳的C++实战项目。通过开发串口工具，你能系统掌握：
- QT框架的UI开发流程
- 串口通信的核心原理
- 数据解析与显示技巧
- 软件打包发布的全流程
2. 开发环境准备：QT5.15安装详解
2.1 QT安装前的准备工作
QT从5.15版本开始改变了安装策略，官方只提供在线安装方式。这里分享几个实测有效的提速技巧：
首先访问QT官方下载页面（建议使用Chrome浏览器），找到5.15.2版本。虽然最新版已经到6.x，但考虑到稳定性与兼容性，5.15仍然是工业领域的首选。
注册QT账号时有个小技巧：使用企业邮箱注册成功率更高。遇到过有开发者用免费邮箱收不到验证码的情况。注册完成后，建议先登录一次账号，确保状态正常。
2.2 组件选择指南
安装过程中最关键的环节就是组件选择。根据多年经验，推荐这样配置：
必选组件：
- Qt Creator 4.11.0（集成开发环境）
- Qt 5.15.2 → MinGW 8.1.0 64-bit（编译器）
- Qt Charts（数据可视化）
- Qt SerialPort（串口支持）
可选组件：
- Qt Virtual Keyboard（如果需要触屏输入）
- Qt Quick 3D（3D可视化需求）
- Qt Multimedia（音视频处理）
安装路径有个注意事项：路径中不要包含中文或空格。我习惯放在C:\Qt这样的简单路径下，避免后续各种奇怪的兼容性问题。
安装完成后，建议立即运行Qt Creator，检查是否能正常启动。如果遇到"缺少dll"之类的错误，通常是环境变量没配置好。可以手动添加C:\Qt\5.15.2\mingw81_64\bin到系统Path变量。
3. 创建第一个QT项目
3.1 项目初始化步骤
打开Qt Creator后，跟着这些步骤操作：
- 点击"新建项目"
- 选择"Application" → "Qt Widgets Application"
- 命名项目为
SerialTool（注意全英文） - 选择qmake构建系统
- 基类选择QWidget
- 使用默认的MinGW编译器
创建完成后，你会看到这样的项目结构：
SerialTool/ ├── SerialTool.pro # 项目配置文件 ├── main.cpp # 程序入口 ├── widget.h # 主窗口头文件 ├── widget.cpp # 主窗口实现 └── widget.ui # 界面设计文件3.2 关键配置文件解析
打开SerialTool.pro文件，我们需要添加串口支持模块：
QT += core gui serialport greaterThan(QT_MAJOR_VERSION, 4): QT += widgets这个文件相当于项目的总控开关，所有依赖库都在这里声明。后续如果需要添加图表、网络等功能，也是在这里添加对应的模块。
main.cpp文件通常不需要修改，保持默认即可。它的核心作用是创建应用程序实例并显示主窗口：
#include "widget.h" #include <QApplication> int main(int argc, char *argv[]) { QApplication a(argc, argv); Widget w; w.show(); return a.exec(); }4. 设计串口工具界面
4.1 基础UI布局设计
双击widget.ui文件进入设计模式。我们先搭建一个最基础的串口工具界面：
从左侧Widget Box拖拽以下控件：
- 3个ComboBox（串口选择、波特率、校验位）
- 1个PushButton（打开/关闭串口）
- 2个TextEdit（发送区、接收区）
- 2个PushButton（发送、清空）
使用Vertical Layout和Horizontal Layout进行排版，确保窗口缩放时控件能自适应
设置关键控件对象名（后面编程要用）：
- 串口选择：comboPort
- 波特率选择：comboBaud
- 打开按钮：btnOpen
- 发送文本框：textSend
- 接收文本框：textRecv
4.2 界面美化技巧
想让界面更专业？试试这些技巧：
- 使用QSS设置样式：
QPushButton { min-width: 80px; padding: 5px; background: #3498db; color: white; border-radius: 4px; }- 为接收区设置等宽字体：
textRecv->setFont(QFont("Courier New", 10));- 添加状态栏显示连接状态
- 使用QSplitter让发送/接收区可以自由调整大小
5. 实现串口通信功能
5.1 串口初始化代码
在widget.h中添加头文件和成员变量：
#include <QSerialPort> #include <QSerialPortInfo> private: QSerialPort *serial;在Widget类的构造函数中初始化串口对象：
Widget::Widget(QWidget *parent) : QWidget(parent) { // ...其他初始化代码 serial = new QSerialPort(this); connect(serial, &QSerialPort::readyRead, this, &Widget::readData); // 扫描可用串口 foreach(const QSerialPortInfo &info, QSerialPortInfo::availablePorts()) { comboPort->addItem(info.portName()); } // 设置常用波特率 QStringList baudRates = {"9600", "19200", "38400", "57600", "115200"}; comboBaud->addItems(baudRates); comboBaud->setCurrentText("115200"); }5.2 核心功能实现
添加打开/关闭串口的槽函数：
void Widget::on_btnOpen_clicked() { if(serial->isOpen()) { serial->close(); btnOpen->setText("打开串口"); } else { serial->setPortName(comboPort->currentText()); serial->setBaudRate(comboBaud->currentText().toInt()); serial->setDataBits(QSerialPort::Data8); serial->setParity(QSerialPort::NoParity); serial->setStopBits(QSerialPort::OneStop); if(serial->open(QIODevice::ReadWrite)) { btnOpen->setText("关闭串口"); } else { QMessageBox::critical(this, "错误", "无法打开串口！"); } } }实现数据接收函数：
void Widget::readData() { QByteArray data = serial->readAll(); textRecv->moveCursor(QTextCursor::End); textRecv->insertPlainText(data); }6. 高级功能扩展
6.1 十六进制显示与发送
很多嵌入式场景需要处理十六进制数据。我们可以添加一个CheckBox来控制显示模式：
void Widget::on_checkHex_stateChanged(int state) { isHexMode = (state == Qt::Checked); } void Widget::readData() { QByteArray data = serial->readAll(); QString displayText; if(isHexMode) { displayText = data.toHex(' ').toUpper(); } else { displayText = QString::fromLocal8Bit(data); } textRecv->append(displayText); }6.2 数据发送优化
增强发送功能，支持定时发送和换行符处理：
void Widget::on_btnSend_clicked() { QString text = textSend->toPlainText(); if(isHexMode) { QByteArray hexData = QByteArray::fromHex(text.toLatin1()); serial->write(hexData); } else { if(checkNewLine->isChecked()) { text += "\r\n"; } serial->write(text.toLocal8Bit()); } }7. 软件打包与发布
7.1 Release版本生成
- 将构建模式切换为Release
- 点击"构建"→"重新构建项目"
- 生成的exe位于
build-SerialTool-Release/release目录
7.2 使用windeployqt打包
打开QT命令行工具，执行：
cd /d D:\Projects\SerialTool\build-SerialTool-Release\release windeployqt SerialTool.exe这个命令会自动收集所有依赖的dll文件。要制作绿色版软件，只需将整个release文件夹打包即可。如果需要安装包，可以使用Inno Setup等工具制作专业安装程序。
第一次运行打包后的程序时，可能会遇到缺少VC++运行库的问题。解决方法有两种：要么让用户提前安装运行库，要么静态编译QT程序（但这会显著增大程序体积）。