QCustomPlot是一个基于Qt C++的图形库，用于绘制和数据可视化 - 制作漂亮的2D图 - 曲线图、趋势图、坐标图、柱状图等，并为实时可视化应用程序提供高性能服务。它没有进一步的依赖关系，并有着良好的文档记录。

QCustomPlot可以导出为各种格式，比如：PDF文件和位图（如：PNG、JPG、BMP）。

可在自己的项目中直接使用两个源文件（qcustomplot.h与qcustomplot.cpp）或预先编译成库。

QCustomPlot是一个小型的qt画图标类，效果可以，易用，只需要在项目中加入头文件qcustomplot.h和qcustomplot.cpp文件，然后使一个widget提升为QCustomPlot类，即可使用。 QCustomPlot 可以导出为各种格式，如矢量化 PDF 文件和光栅化图像，如 PNG、JPG 和 BMP。QCustomPlot 是在应用程序内显示实时数据以及为其他媒体生成高质量绘图的解决方案。

QCustomPlot是目前使用最为广泛的Qt图表类；

Qt的QWidget代码方向图表类只有QtCharts，Qwt，QCustomPlot

绘制实时数据波形图，我们一般使用到的库有qwt、qcustomplot以及官方的QtCharts模块。

美观：Qcustomplot≈Qchart > Qwt 性能：Qcustomplot >Qchart> Qwt

绘制1000个数据点时，qcustomplot平均耗时 13.6毫秒，Qwt平均耗时40毫秒，QChart平均耗时12.5毫秒; 绘制10000个数据点时，qcustomplot平均耗时 21.6毫秒，Qwt平均耗时78毫秒，QChart平均耗时13.5毫秒; 绘制100000个数据点时，qcustomplot平均耗时22.5毫秒，Qwt平均耗时524毫秒，QChart平均耗时20.7毫秒； 绘制500000个数据点时，qcustomplot平均耗时43.3毫秒，QChart平均耗时194.25毫秒。

从性能角度

QCustomPlot是一个比较完善的框架，其框架和缓存化的处理使其处理性能大幅度提升（设置笔宽为1，可撑起几百万点），而QtCharts只是一个半成品，不论是否有bug，QtCharts在两千个点以内是可以使用的，超过两千个点就存在刷新卡顿的问题（很大可能）。

从定制化角度

QCustomPlot修改源码因为其是一步一步继承过来的，修改起来是比较麻烦的，还需要反复调试以防止修改了代码出现了其他问题，入添加一个少则半天一天，多则几天，所以如果需要定制修改QCustomoPlot源码的需求，是需要进一步仔细评估是否值得这么做。

最新版本：2.1.0，于2021年3月29日发布： 它建立了高达Qt 6.0的兼容性（保持兼容性一直到4.6），并包括许多功能添加，错误修复和较小的改进，增加了极坐标波形绘制控件等，需要C++11支持。具体见详细变更列表日志。

官方提供的demo提供了4个例程，这里初入手的特别注意范例plot-examples,其包含了多种效果，修改代码的数字实现不同的demo，如果修改 setupDemo(1);如下图：是Realtime Data Demo。这个就是绘制实时数据的demo。

官网下载地址：Qt Plotting Widget QCustomPlot - Download 不用纠结具体哪个版本，根据提示选择自己Qt版本对应的就可以。推荐下载完整包，包括源码、文档和例程。

进入QCustomPlot下载页，下载最新的完整包（包含：源码、文档、示例）！

将下载好的安装包进行解压缩，里面包含文档、示例、更改日志、GPL授权、以及最重要的两个文件qcustomplot.h与qcustomplot.cp

1、下载的QCustomPlot压缩包解压后，把qcustomplot.h和qcustomplot.cpp文件拷贝到工程文件夹，在左侧工程名称上右键点击弹出对话框，选择“添加现有文件”，选中qcustomplot.h和qcustomplot.cpp文件，添加到工程目录，如下图：

2、在工程的.pro文件中可以看到添加记录，同时在Qt5以上版本中，需要添加 printsupport。如下图所示：

3、接下来我们在界面中拖拽一个Widget控件，选中并右键选中“提升为”，如下图所示：

4、在弹出的对话框中输入 QCustomPlot ，自动匹配 qcustomplot.h，再点击“添加”，选中后点击“提升”，则原来的Widget控件已成为一个带坐标的 CustomPlot 控件，如下图：

如果是代码方式添加就不需要对控件提升的这布操作，直接使用QCustomPlot 类声明对象即可。如

5、添加printsupport

如果Qt版本在5.0以上，需要在.pro文件中的QT变量加上printsupport：

QT += widgets printsupport

6、添加帮助文档 在下载的documentation文件夹下有个qcustomplot.qch文件，将它拷贝Qt的安装文档目录下（一般为qt5.9\Docs\Qt-5.9，会根据你的Qt版本号而做相应变动），然后在QtCreator ——>工具——>选项——>帮助——>文档——>添加，选择qcustomplot.qch文件，确定，以后按F1就能跳转到QCustomPlot的帮助  

至此，我们已经完成了对QCustomPlot的调用。接下来就可以在QCustomPlot控件进行绘图操作了~

我们先把拖拽并提升为QCustomPlot的widget控件改名为customplot，以示区分。

我们添加的QCustomPlot控件，是一个画布，我们可以在同一个画布上画很多曲线。那么首先我们需要添加曲线，函数是

设置曲线的具体数据的函数是

这里的keys是x坐标，values是y坐标，均为QVector类型。因此我们需要先用QVector赋值一对点集，作为x和y坐标。代码如下：

把完成代码放在MainWindow初始化函数或某个控件点击函数，执行动作后可显示如下曲线：

当然，这个曲线的很单调，还是个折线图，显示也不完全，还需要做很多修饰。按照感觉舒适度，有几个点是要做的，主要有：

我们先按照上面列举的舒适度顺序来优化先曲线

我们可以手动设置坐标轴范围，也可以自动设置。

根据x轴范围(-50,50)，则y轴范围是(1,2500)，我们先手动设置下：

自动设置，即自适应坐标范围代码如下：

两种方式得到相同的曲线，如下图：

我们给坐标轴加个名称和单位，代码如下：

我们再给曲线加个标题，代码如下：

这里涉及到QCustomPlot的布局系统，用于管理标题、图例、网格、坐标轴矩形等元素，可参见其他博主译文：QCustomPlot之布局系统

在设置坐标轴名称和添加标题后，曲线显示如下：

到这里，一个基本完整的曲线就完成了，我们再把代码总结下：