QT集成QRencode与Code128：从源码集成到界面绘制的条码生成实战
1. 为什么选择QT集成条码生成功能
在开发GUI应用时，条码功能的需求非常普遍。无论是商品管理系统、仓储物流软件还是会员卡应用，都需要快速生成可识别的条形码或二维码。QT作为跨平台的C++框架，原生并未提供条码生成模块，这就需要我们引入第三方库来实现。
我经历过多个需要集成条码功能的QT项目，发现QRencode和Code128这两个库的组合能覆盖90%的业务场景。QRencode生成的二维码可以存储网址、联系方式等复杂信息，而Code128生成的条形码特别适合编码数字和字母组合，比如产品序列号、订单编号等。
这两个库的优势很明显：首先它们都是开源项目，不用担心授权问题；其次代码量不大，集成到QT项目中不会显著增加体积；最重要的是生成速度快，实测在普通PC上生成一个复杂二维码只需3-5毫秒，完全能满足实时生成的需求。
2. 准备开发环境与源码
2.1 获取QRencode源码
QRencode的最新稳定版是4.1.1，可以直接从官网下载。我习惯把源码包解压到项目目录下的ThirdParty文件夹，这样便于管理第三方依赖。解压后你会看到很多文件，但实际上我们只需要保留这几个：
- 所有.h头文件
- 所有.c源文件
- config.h.in配置文件
特别提醒：qrenc.c是命令行工具源码，我们不需要它，可以直接删除。config.h.in需要重命名为config.h，并修改里面的版本定义：
#define MAJOR_VERSION 4 #define MICRO_VERSION 1 #define MINOR_VERSION 1 #define VERSION "4.1.1"2.2 处理Code128源码
Code128的实现我推荐GitHub上的promixis/Code128项目。这个实现非常轻量，只有两个文件：
- Code128.h
- Code128.cpp
需要注意的是，如果使用MSVC编译器，需要将源码中的Symbol类型定义改为：
typedef QString Symbol;3. 使用.pri文件模块化集成
3.1 创建QRencode.pri文件
QT的.pri文件非常适合用来管理模块化代码。我在QRencode源码同级目录创建QRencode.pri，内容如下：
DEFINES += HAVE_CONFIG_H HEADERS += \ $$PWD/bitstream.h \ $$PWD/config.h \ $$PWD/qrencode.h \ # 其他头文件... SOURCES += \ $$PWD/bitstream.c \ $$PWD/qrencode.c \ # 其他源文件...3.2 在项目中使用.pri文件
在项目的.pro文件中添加：
include(ThirdParty/QRencode/QRencode.pri) include(ThirdParty/Code128/Code128.pri)这种方式的优势是：
- 保持源码目录结构清晰
- 方便多项目共享同一套代码
- 切换编译环境时不需要重新配置
4. 实现Code128条形码生成
4.1 基本生成逻辑
Code128的编码过程很简单：
QString text = "ABC123"; Code128::BarCode barcode = Code128::encode(text);但要将条形码绘制到界面上，需要一些计算：
float totalWidth = 0; for(int i=0; i<barcode.length(); i++) { totalWidth += barcode[i]; } float lineWidth = targetWidth / totalWidth;4.2 使用QPainter绘制
绘制条形码的核心代码如下：
QImage img(width, height, QImage::Format_ARGB32); QPainter painter(&img); // 绘制白色背景 painter.fillRect(QRect(0, 0, width, height), Qt::white); float x = 0; for(int i=0; i<barcode.length(); i++) { float w = barcode[i] * lineWidth; if(i % 2 == 0) { // 绘制黑条 painter.fillRect(QRectF(x, 0, w, height), Qt::black); } x += w; }实际项目中我遇到过两个坑：
- 条码太密集导致扫描器无法识别 - 需要适当增加绘制高度
- 某些扫描器对左右空白区有要求 - 需要在两端留出足够空白
5. 实现QR二维码生成
5.1 生成二维码数据
QRencode的使用稍微复杂些：
QString text = "https://example.com"; QRcode* qrcode = QRcode_encodeString(text.toUtf8().constData(), 2, QR_ECLEVEL_Q, QR_MODE_8, 1);参数说明：
- 2: 版本号，0表示自动选择
- QR_ECLEVEL_Q: 纠错级别
- QR_MODE_8: 编码模式
- 1: 是否区分大小写
5.2 绘制二维码到界面
二维码绘制要考虑缩放问题：
int qrWidth = qrcode->width; float cellSize = targetSize / qrWidth; for(int y=0; y<qrWidth; y++) { for(int x=0; x<qrWidth; x++) { if(qrcode->data[y*qrWidth + x] & 1) { painter.fillRect(QRectF(x*cellSize, y*cellSize, cellSize, cellSize), Qt::black); } } }为了提高识别率，我通常会：
- 增加4px的白色边框
- 在复杂背景下添加对比边框
- 避免缩放导致像素模糊
6. 高级功能与优化
6.1 动态调整条码尺寸
在实际应用中，经常需要根据容器大小自动调整条码尺寸。我的做法是：
void resizeBarcode() { int w = ui->label->width(); int h = ui->label->height(); QImage scaled = originalImage.scaled(w, h, Qt::KeepAspectRatio, Qt::FastTransformation); ui->label->setPixmap(QPixmap::fromImage(scaled)); }6.2 添加容错处理
条码生成可能失败，必须添加错误处理：
if(!qrcode) { qDebug() << "生成二维码失败:" << QRcode_APIVersionString(); return; }对于Code128，要注意它不支持中文，如果输入中文需要提前转换：
QString encoded = text.toLatin1(); if(encoded != text) { qWarning() << "Code128不支持中文，已自动过滤"; }7. 实际应用中的经验分享
在电商系统中，我们同时使用两种条码：
- 商品SKU用Code128编码，因为扫描速度快
- 商品详情页链接用QR编码，方便手机扫码
性能方面，在i5处理器上测试：
- Code128生成1000个条码耗时约120ms
- QR二维码(版本2)生成100个耗时约300ms
遇到过一个典型问题：某仓库扫描器无法识别生成的Code128码。后来发现是条高不足，将高度从20px调整到50px后解决。这也提醒我们，生成条码时要考虑实际使用场景的硬件限制。