简介：这份资源是面向Qt开发者与科学可视化学习者的QWT图表综合应用源码集合，围绕Qt平台下的2D绘图需求，提供可直接研读与复用的工程示例。压缩包共25个文件，以9个cpp源文件、8个h头文件、6个ui界面文件为主，另含pro工程文件与user配置，整体约27KB，体量轻巧却覆盖完整工程结构。内容涉及线图、散点图、条形图、饼图、极坐标图等常见图表类型的实例化与样式配置，并包含鼠标交互、拖拽缩放、图例选择等事件处理逻辑，以及动态数据更新、自定义绘图元素、布局嵌入与数据导入导出等实践要点。已有171人学习下载，适合初学者快速上手QWT基本用法，也便于有经验的开发者深入理解图表绘制机制与性能优化思路，从而提升Qt环境下复杂图形编程能力。
1. 从一份 Qwt 图表综合源码包说起：它到底能解决什么
如果你正在用 Qt 做工业上位机、测试测量软件或者数据监控界面，大概率绕不开一个名字——Qwt。这个库把曲线、柱状图、仪表盘、频谱图这些常用控件封装得相当完整，但真正动手时你会发现，官方示例散落在各个角落，每个例子只讲一个点，想把它们拼成一个能跑的综合界面，中间要填的坑不少。我手里这份qwt图表综合应用集合源码.rar，就是一份把 Qwt 常见图表场景集中到一起的源码集合，覆盖曲线绘制、坐标轴定制、实时刷新、图例交互、数据缩放这些高频需求。它适合两类人：一是刚接触 Qwt、想快速看到各种图表长什么样、参数怎么调的新手；二是已经在项目里用 Qwt、但被某个具体效果卡住、需要一份可参考实现的老手。下面我按实际拆包和编译的顺序，把这份资源从环境配置到进阶技巧完整走一遍，中间会重点说清楚哪些参数必须改、哪些坑我亲自踩过。
2. 环境搭建与工程结构：把源码跑起来的第一步
2.1 Qt 版本与 Qwt 编译方式的选择
拿到源码包之后，第一件事不是急着打开.pro文件，而是确认你本地的 Qt 版本和 Qwt 版本能不能对上。这份源码集合里大部分工程用的是 Qt 5 的qmake构建体系，少数几个带CMakeLists.txt的是给 Qt 6 准备的。如果你本地是 Qt 6 但只有 qmake 工程，直接打开会报一堆QRegExp相关的编译错误，因为 Qt 6 已经把QRegExp移到了兼容模块里。常见做法是：先看工程根目录有没有.pro文件，有就用 Qt 5 的 Kit 打开；如果只有CMakeLists.txt，那就用 Qt 6 的 Kit，并且确认Qwt已经用 CMake 方式编译安装过。
Qwt 本身的编译有两种路子：一种是直接用官方提供的.pro文件在 Qt Creator 里构建，生成qwt.dll和qwt.lib（Windows）或者libqwt.so（Linux）；另一种是用 CMake 构建，适合集成到现代 CMake 工程里。我一般会选第一种，因为这份源码包里的工程大多是用qmake写的，LIBS += -lqwt这种写法在 qmake 下最省事。编译 Qwt 的时候有一个关键参数：QWT_CONFIG里的QwtPlot、QwtWidgets、QwtSvg这几个宏要打开，否则源码里用到QwtPlotSpectrogram或者QwtPlotPolar的地方会链接失败。
# 以 Linux 下编译 Qwt 为例，进入 qwt 源码目录 qmake qwt.pro make -j4 sudo make install # 安装完成后，头文件通常在 /usr/local/include/qwt，库文件在 /usr/local/lib这段命令的逻辑是：先用qmake生成 Makefile，然后并行编译，最后安装到系统目录。参数-j4表示用 4 个线程加速编译，具体数字按你机器的 CPU 核心数调整。安装完成后，你需要在 Qt 工程的.pro文件里加上INCLUDEPATH += /usr/local/include/qwt和LIBS += -L/usr/local/lib -lqwt，否则编译器找不到头文件和库。
提示：Windows 下如果用 MSVC 编译 Qwt，记得把
qwt.dll放到可执行文件同级目录，或者把qwt.lib所在路径加入PATH，否则运行时会提示找不到动态库。
2.2 工程文件里的关键配置项
打开源码包里的任意一个.pro文件，你会看到类似下面的内容：
QT += core gui widgets printsupport TARGET = QwtPlotDemo TEMPLATE = app INCLUDEPATH += $$PWD/../../qwt/include LIBS += -L$$PWD/../../qwt/lib -lqwt SOURCES += main.cpp \ mainwindow.cpp HEADERS += mainwindow.h这里有几个参数值得注意。QT += printsupport是必须的，因为 Qwt 的绘图控件依赖 Qt 的打印支持模块，少了这一行会在链接阶段报QPrinter相关的未定义符号。INCLUDEPATH和LIBS里的$$PWD是 qmake 的内置变量，表示当前.pro文件所在目录，用相对路径可以避免换机器后路径失效。如果你把 Qwt 装到了系统目录，这两行可以改成绝对路径或者直接省略，让编译器去默认搜索路径里找。
还有一个容易忽略的点：源码包里有些工程用了QwtPlot3D，这是一个独立于 Qwt 的三维绘图库，需要单独下载编译。如果你只关心二维图表，可以在.pro里把相关源文件排除掉，或者直接注释掉对应的SOURCES和HEADERS条目。
3. 核心图表类型的实现拆解：曲线、柱状与实时刷新
3.1 曲线绘制与坐标轴定制
Qwt 里最常用的控件是QwtPlot，它本身是一个容器，真正的曲线由QwtPlotCurve负责绘制。下面这段代码展示了如何创建一个带自定义坐标轴的曲线图：
// 创建绘图控件 QwtPlot *plot = new QwtPlot(this); plot->setTitle("曲线示例"); plot->setCanvasBackground(Qt::white); // 设置 X 轴和 Y 轴的范围 plot->setAxisScale(QwtPlot::xBottom, 0.0, 10.0); plot->setAxisScale(QwtPlot::yLeft, -1.0, 1.0); // 创建曲线对象 QwtPlotCurve *curve = new QwtPlotCurve("正弦波"); curve->setPen(Qt::blue, 2); curve->setRenderHint(QwtPlotItem::RenderAntialiased, true); // 准备数据 QVector<double> xData, yData; for (int i = 0; i < 100; ++i) { double x = i * 0.1; xData.append(x); yData.append(qSin(x)); } curve->setSamples(xData, yData); curve->attach(plot); plot->replot();这段代码的逻辑是：先创建QwtPlot并设置标题和背景色，然后用setAxisScale分别指定 X 轴和 Y 轴的数值范围。QwtPlotCurve的setPen控制线条颜色和宽度，setRenderHint打开抗锯齿让曲线更平滑。数据通过setSamples传入，最后必须调用attach把曲线挂到绘图控件上，再replot触发重绘。参数方面，xBottom和yLeft是 Qwt 预定义的轴标识符，分别代表底部 X 轴和左侧 Y 轴；如果你需要顶部或右侧轴，可以用xTop和yRight，但默认它们是隐藏的，需要手动enableAxis。
坐标轴定制是很多人卡住的地方。比如你想把 X 轴改成时间格式，需要继承QwtScaleDraw并重写label方法：
class TimeScaleDraw : public QwtScaleDraw { public: virtual QwtText label(double value) const override { QDateTime dt = QDateTime::fromSecsSinceEpoch(static_cast<qint64>(value)); return dt.toString("hh:mm:ss"); } }; // 使用方式 plot->setAxisScaleDraw(QwtPlot::xBottom, new TimeScaleDraw());这里label方法接收轴上的数值，返回一个QwtText对象作为显示文本。fromSecsSinceEpoch把秒数转成QDateTime，再格式化成时分秒。注意QwtText支持富文本，如果你想让标签换行或者加粗，可以用 HTML 标签。
3.2 柱状图与图例交互
柱状图在 Qwt 里对应的是QwtPlotBarChart，它和曲线图最大的区别在于数据组织方式。下面是一个简单的柱状图实现：
// 创建柱状图对象 QwtPlotBarChart *barChart = new QwtPlotBarChart("销量"); barChart->setSamples(QVector<double>{12, 35, 28, 47, 33}); // 设置柱子的颜色和边框 QwtColumnSymbol *symbol = new QwtColumnSymbol(QwtColumnSymbol::Box); symbol->setFrameStyle(QwtColumnSymbol::Raised); symbol->setLineWidth(2); symbol->setPalette(QPalette(Qt::green)); barChart->setSymbol(symbol); barChart->attach(plot); plot->replot();setSamples传入的是每个柱子的高度值，X 轴会自动按索引排列。QwtColumnSymbol控制柱子的外观，Box表示矩形柱，Raised是立体边框效果，setPalette设置填充色。如果你想让柱子带渐变，可以用QLinearGradient构造QBrush再传给setPalette。
图例交互是这份源码包里比较实用的部分。默认情况下，QwtPlot的图例是QwtLegend，点击图例项可以切换对应曲线的显示和隐藏。实现方式是在创建曲线时给QwtPlotItem设置一个唯一的title，然后QwtLegend会自动根据这个 title 生成可点击的条目。如果你想让图例显示在绘图区域内部而不是外部，可以调用plot->setLegendPosition或者把QwtLegend的父控件设为plot->canvas()。
注意：图例的点击响应依赖
QwtPlotPicker或者手动连接legend->clicked信号。如果你发现点击没反应，检查一下是否在attach之前设置了 title，以及QwtLegend是否已经通过insertLegend插入到 plot 中。
3.3 实时数据刷新与性能取舍
实时刷新是工业场景里最常见的需求，也是性能问题的高发区。很多新手会直接在一个QTimer里反复调用setSamples然后replot，数据量小的时候没问题，一旦点数超过几千，界面就会明显卡顿。正确的做法是使用QwtPlotCurve的setRawSamples接口，它直接引用外部数组，避免了每次拷贝数据的开销：
// 预分配数据缓冲区 static double xData[1000]; static double yData[1000]; QwtPlotCurve *curve = new QwtPlotCurve("实时数据"); curve->setRawSamples(xData, yData, 1000); curve->attach(plot); // 定时器回调中更新数据 QTimer *timer = new QTimer(this); connect(timer, &QTimer::timeout, [=]() { // 模拟新数据，实际项目中从设备读取 for (int i = 0; i < 999; ++i) { yData[i] = yData[i + 1]; } yData[999] = QRandomGenerator::global()->bounded(100) / 100.0; curve->setRawSamples(xData, yData, 1000); plot->replot(); }); timer->start(50); // 20 FPS这段代码的关键在于setRawSamples不会复制数据，它只是保存了指针。所以xData和yData必须是静态数组或者生命周期覆盖整个绘图过程的堆内存。定时器间隔设为 50 毫秒，对应 20 帧每秒，对于大多数监控场景已经足够。如果你需要更高的刷新率，可以把replot换成plot->canvas()->replot()，只重绘画布区域，减少不必要的重绘开销。
参数方面，setRawSamples的第三个参数是点数，必须和数组实际长度一致，否则会读到越界内存。另外，如果你在多线程环境里更新数据，记得加锁或者用QMetaObject::invokeMethod把更新操作抛回主线程，Qwt 的绘图控件不是线程安全的。
4. 避坑与排查：编译、运行和显示中的常见问题
4.1 编译时报 “undefined reference to QwtPlot::xxx”
现象：工程能编译通过，但链接阶段报一堆undefined reference，指向QwtPlot、QwtPlotCurve等类的方法。
原因：.pro文件里的LIBS路径不对，或者 Qwt 库的版本和头文件版本不匹配。常见情况是你编译 Qwt 时用的是 Qt 5.15，但工程用的是 Qt 5.12，ABI 不兼容导致符号找不到。
解决：先确认qmake -v输出的 Qt 版本和编译 Qwt 时用的版本一致。然后检查LIBS路径下是否存在libqwt.so或qwt.lib。如果路径没问题，尝试把LIBS += -lqwt改成LIBS += -lqwt -lqwtmathml，因为部分 Qwt 功能依赖数学标记语言模块。
4.2 运行时报 “Could not load the Qt platform plugin”
现象：程序编译成功，双击运行或者命令行启动时弹出这个错误，窗口出不来。
原因：Qt 的平台插件没有正确部署。Windows 下通常是platforms/qwindows.dll没放到可执行文件目录；Linux 下可能是xcb插件缺失或者DISPLAY环境变量没设置。
解决：Windows 下用windeployqt工具自动拷贝依赖，命令是windeployqt your_app.exe。Linux 下确认libxcb-xinerama0等依赖库已安装，如果是远程终端运行，需要设置export DISPLAY=:0或者用xvfb虚拟显示。
4.3 曲线显示为空白或者只有坐标轴
现象：程序正常运行，坐标轴和标题都显示出来了，但曲线区域一片空白。
原因：最常见的是setSamples传入的数据范围超出了坐标轴的显示范围。比如你设置了 Y 轴范围是-1到1，但数据实际是100到200，曲线自然跑到可视区域外面去了。
解决：先调用plot->setAxisAutoScale(QwtPlot::yLeft)让 Qwt 自动计算范围，确认曲线能显示后再手动设置精确范围。另一个可能是attach调用顺序问题——必须先attach再replot，反过来不会报错但曲线不显示。
4.4 实时刷新时界面卡顿甚至无响应
现象：数据量不大，但界面刷新时鼠标点击没反应，窗口拖动也卡。
原因：replot默认会重绘整个QwtPlot，包括坐标轴、图例、背景，开销比只重绘画布大得多。如果定时器间隔又很短，主线程被绘图占满，自然无法响应界面事件。
解决：把replot换成plot->canvas()->replot()，只更新数据区域。另外检查定时器间隔是否小于 20 毫秒，低于这个值人眼已经分辨不出差别，但 CPU 占用会翻倍。如果数据点超过 5000 个，考虑用QwtPlotCurve::setRawSamples配合QwtPlotDirectPainter做增量绘制，只画新增的点。
4.5 图例点击后曲线消失但坐标轴没更新
现象：点击图例隐藏某条曲线后，Y 轴范围还是按原来的数据算的，导致剩余曲线被压扁。
原因：Qwt 的自动缩放默认只考虑可见的曲线，但如果你手动设置过setAxisScale，自动缩放就被禁用了。
解决：在图例点击的信号处理函数里，重新调用plot->setAxisAutoScale(QwtPlot::yLeft)再replot。或者用QwtPlot::updateAxes强制刷新轴范围。
5. 进阶技巧：从能跑到好用，几个我常用的参数调优
5.1 用 QwtPlotPicker 实现数据点拾取
数据点拾取是很多监控软件的基本功能——鼠标悬停在曲线上时显示当前点的数值。Qwt 提供了QwtPlotPicker类，但默认配置下它只显示坐标，不显示具体数值。下面是我常用的配置方式：
// 创建拾取器，绑定到画布 QwtPlotPicker *picker = new QwtPlotPicker( QwtPlot::xBottom, QwtPlot::yLeft, QwtPlotPicker::CrossRubberBand, QwtPicker::AlwaysOn, plot->canvas() ); // 设置追踪模式，鼠标移动时实时显示 picker->setTrackerMode(QwtPicker::ActiveOnly); picker->setRubberBandPen(QColor(Qt::red)); picker->setTrackerPen(QColor(Qt::black)); // 自定义追踪文本 class MyTracker : public QwtPlotPicker { public: MyTracker(QWidget *canvas) : QwtPlotPicker(canvas) {} protected: virtual QwtText trackerTextF(const QPointF &pos) const override { return QwtText(QString("X: %1\nY: %2") .arg(pos.x(), 0, 'f', 2) .arg(pos.y(), 0, 'f', 2)); } };这里CrossRubberBand表示十字准线样式，AlwaysOn让拾取器始终激活。trackerTextF是虚函数，重写它可以自定义显示格式。arg里的0, 'f', 2表示保留两位小数。如果你想让追踪框跟随鼠标但不遮挡曲线，可以设置setTrackerPosition为QwtPicker::AboveCursor。
5.2 导出高清图片与打印支持
Qwt 内置了导出功能，但默认导出的图片分辨率是屏幕分辨率，放到报告里会模糊。我一般会用QwtPlotRenderer手动渲染到QImage：
QwtPlotRenderer renderer; renderer.setDiscardFlag(QwtPlotRenderer::DiscardBackground, false); renderer.setLayoutFlag(QwtPlotRenderer::KeepFrames, true); QImage image(1920, 1080, QImage::Format_ARGB32); image.fill(Qt::white); QPainter painter(&image); renderer.render(plot, &painter, plot->rect()); painter.end(); image.save("plot_export.png");setDiscardFlag控制是否丢弃背景，设为false表示保留白色背景。setLayoutFlag的KeepFrames让导出的图片保留坐标轴边框。render方法的第三个参数是绘制区域，这里用plot->rect()表示整个绘图控件。如果你需要导出 PDF，把QImage换成QPrinter并设置setOutputFormat(QPrinter::PdfFormat)即可。
5.3 多轴与双 Y 轴曲线的对齐
双 Y 轴在对比不同量纲的数据时很常用，比如左边显示温度、右边显示压力。Qwt 实现双 Y 轴的核心是创建两个QwtPlotCurve，分别 attach 到yLeft和yRight，然后手动设置两个轴的范围使得曲线在视觉上对齐：
// 左轴曲线 QwtPlotCurve *tempCurve = new QwtPlotCurve("温度"); tempCurve->setSamples(tempData); tempCurve->setAxes(QwtPlot::xBottom, QwtPlot::yLeft); tempCurve->attach(plot); // 右轴曲线 QwtPlotCurve *pressureCurve = new QwtPlotCurve("压力"); pressureCurve->setSamples(pressureData); pressureCurve->setAxes(QwtPlot::xBottom, QwtPlot::yRight); pressureCurve->attach(plot); // 启用右轴并设置范围 plot->enableAxis(QwtPlot::yRight); plot->setAxisScale(QwtPlot::yLeft, 0, 100); plot->setAxisScale(QwtPlot::yRight, 0, 10);关键点是setAxes方法，它指定曲线使用哪个 X 轴和 Y 轴。enableAxis必须调用，否则右轴不显示。两个轴的范围要独立设置，但为了让曲线在视觉上不重叠得太厉害，可以调整其中一个轴的缩放比例。我通常会把两条曲线的零点对齐，这样对比趋势时更直观。
5.4 一个我踩过的坑：Qwt 版本升级后的 API 变化
Qwt 从 6.1 升级到 6.2 时，QwtPlotCurve::setData方法被标记为废弃，推荐改用setSamples。如果你拿到的源码包是基于旧版本写的，编译时会看到一堆警告，虽然不影响运行，但后续维护会越来越麻烦。我的习惯是：拿到任何 Qwt 源码，先看qwt_global.h里的QWT_VERSION宏，确认版本号后再决定要不要批量替换 API。替换的时候注意setData的参数顺序和setSamples不同，前者是(const double *xData, const double *yData, int size)，后者是(const QVector<double> &xData, const QVector<double> &yData)，直接替换会编译报错。
从那以后我每次拿到新的 Qwt 源码包，都会先编译一个最小示例确认环境没问题，再逐步把综合工程加进来。这样一旦出错，排查范围小，不至于在一堆文件里大海捞针。希望这份拆解能帮到你，少走一些我当年走过的弯路。
本文还有配套的精品资源，点击获取
