PySide6 QtCharts实战：绘制饼图、条形图、折线图（附代码）

脚本专家

在桌面应用开发中，数据可视化是常见需求。PySide6作为Qt官方的Python绑定，内置了QtCharts模块，相比Matplotlib等第三方库，其图表能原生嵌入GUI窗口，支持交互、主题适配和性能优化。本文通过三个完整示例，演示如何使用PySide6的QtCharts模块制作饼图、条形图和折线图。

环境要求：已安装PySide6（pip install pyside6）。

## 1. 饼图（QPieSeries）

饼图适合展示各部分占整体的比例。核心类为QPieSeries和QPieSlice。

实现步骤：
- 创建QPieSeries对象，使用append()添加标签和数值。
- 可通过slices()获取切片对象，设置突出显示（setExploded）和标签可见（setLabelVisible）。
- 创建QChart并添加Series，设置标题和图例。
- 使用QChartView展示图表，开启抗锯齿渲染。

完整代码：

2. import sys
3. from PySide6.QtWidgets import QApplication, QMainWindow
4. from PySide6.QtCharts import QChart, QChartView, QPieSeries
5. from PySide6.QtGui import QPainter
7. class PieChartWindow(QMainWindow):
8.     def __init__(self):
9.         super().__init__()
10.         self.setWindowTitle("PySide6 饼图示例")
11.         self.resize(600, 400)
13.         # 创建饼图系列
14.         series = QPieSeries()
15.         series.append("Python", 45)
16.         series.append("C++", 25)
17.         series.append("JavaScript", 20)
18.         series.append("Go", 10)
20.         # 突出显示第一块并显示标签
21.         slice_obj = series.slices()[0]
22.         slice_obj.setExploded()
23.         slice_obj.setLabelVisible(True)
25.         # 创建图表
26.         chart = QChart()
27.         chart.addSeries(series)
28.         chart.setTitle("编程语言使用占比")
29.         chart.legend().setVisible(True)
31.         # 创建视图
32.         chart_view = QChartView(chart)
33.         chart_view.setRenderHint(QPainter.RenderHint.Antialiasing)
34.         self.setCentralWidget(chart_view)
36. if __name__ == "__main__":
37.     app = QApplication(sys.argv)
38.     window = PieChartWindow()
39.     window.show()
40.     sys.exit(app.exec())

复制代码

## 2. 条形图（QBarSeries）

条形图（柱状图）用于对比不同类别的数值。涉及QBarSet、QBarSeries和坐标轴类QBarCategoryAxis、QValueAxis。

实现步骤：
- 创建QBarSet实例，用append()添加一组数据。
- 创建QBarSeries，将多个QBarSet添加进去。
- 创建QChart并添加Series，设置动画选项。
- 配置X轴（QBarCategoryAxis）添加类别标签，Y轴（QValueAxis）设置标题和范围。
- 通过attachAxis()将坐标轴与Series绑定。

完整代码：

2. import sys
3. from PySide6.QtWidgets import QApplication, QMainWindow
4. from PySide6.QtCharts import (
5.     QChart, QChartView, QBarSeries, QBarSet,
6.     QBarCategoryAxis, QValueAxis
7. )
8. from PySide6.QtGui import QPainter, Qt
10. class BarChartWindow(QMainWindow):
11.     def __init__(self):
12.         super().__init__()
13.         self.setWindowTitle("PySide6 条形图示例")
14.         self.resize(700, 450)
16.         # 定义数据
17.         set1 = QBarSet("2023年")
18.         set2 = QBarSet("2024年")
19.         set1.append([10, 20, 30, 40])
20.         set2.append([15, 25, 35, 45])
22.         # 创建条形图系列
23.         series = QBarSeries()
24.         series.append(set1)
25.         series.append(set2)
27.         # 创建图表
28.         chart = QChart()
29.         chart.addSeries(series)
30.         chart.setTitle("季度销售额对比")
31.         chart.setAnimationOptions(QChart.AnimationOption.SeriesAnimations)
33.         # X轴（类别）
34.         categories = ["Q1", "Q2", "Q3", "Q4"]
35.         axis_x = QBarCategoryAxis()
36.         axis_x.append(categories)
37.         chart.addAxis(axis_x, Qt.AlignmentFlag.AlignBottom)
38.         series.attachAxis(axis_x)
40.         # Y轴（数值）
41.         axis_y = QValueAxis()
42.         axis_y.setTitleText("销售额 (万元)")
43.         chart.addAxis(axis_y, Qt.AlignmentFlag.AlignLeft)
44.         series.attachAxis(axis_y)
46.         chart.legend().setVisible(True)
48.         # 视图
49.         chart_view = QChartView(chart)
50.         chart_view.setRenderHint(QPainter.RenderHint.Antialiasing)
51.         self.setCentralWidget(chart_view)
53. if __name__ == "__main__":
54.     app = QApplication(sys.argv)
55.     window = BarChartWindow()
56.     window.show()
57.     sys.exit(app.exec())

复制代码

## 3. 折线图（QLineSeries）

折线图展示数据随时间或有序类别变化的趋势，核心类QLineSeries。

实现步骤：
- 创建QLineSeries，使用append(x, y)添加数据点。
- 创建QChart，添加Series，设置标题和动画。
- 配置X轴和Y轴（此处均用QValueAxis），设置范围、标题，并绑定到Series。

完整代码：

2. import sys
3. from PySide6.QtWidgets import QApplication, QMainWindow
4. from PySide6.QtCharts import QChart, QChartView, QLineSeries, QValueAxis
5. from PySide6.QtGui import QPainter
6. from PySide6.QtCore import Qt
8. class LineChartWindow(QMainWindow):
9.     def __init__(self):
10.         super().__init__()
11.         self.setWindowTitle("PySide6 折线图示例")
12.         self.resize(700, 450)
14.         # 创建折线系列
15.         series = QLineSeries()
16.         series.setName("用户增长")
17.         series.append(0, 100)
18.         series.append(1, 150)
19.         series.append(2, 180)
20.         series.append(3, 250)
21.         series.append(4, 320)
22.         series.append(5, 400)
24.         # 创建图表
25.         chart = QChart()
26.         chart.addSeries(series)
27.         chart.setTitle("月度用户增长趋势")
28.         chart.setAnimationOptions(QChart.AnimationOption.SeriesAnimations)
30.         # X轴
31.         axis_x = QValueAxis()
32.         axis_x.setTitleText("月份")
33.         axis_x.setRange(0, 5)
34.         chart.addAxis(axis_x, Qt.AlignmentFlag.AlignBottom)
35.         series.attachAxis(axis_x)
37.         # Y轴
38.         axis_y = QValueAxis()
39.         axis_y.setTitleText("用户数")
40.         axis_y.setRange(0, 500)
41.         chart.addAxis(axis_y, Qt.AlignmentFlag.AlignLeft)
42.         series.attachAxis(axis_y)
44.         chart.legend().setVisible(True)
46.         # 视图
47.         chart_view = QChartView(chart)
48.         chart_view.setRenderHint(QPainter.RenderHint.Antialiasing)
49.         self.setCentralWidget(chart_view)
51. if __name__ == "__main__":
52.     app = QApplication(sys.argv)
53.     window = LineChartWindow()
54.     window.show()
55.     sys.exit(app.exec())

复制代码

## 关键要点总结

- 三层架构：所有图表统一遵循 Series → Chart → ChartView 的构建模式。
- 坐标轴绑定：条形图和折线图需手动创建坐标轴，并调用attachAxis()与Series关联。
- 抗锯齿：setRenderHint(QPainter.RenderHint.Antialiasing)可大幅提升图表边缘平滑度。
- 动画支持：通过setAnimationOptions()可添加系列动画或整体动画，提升用户体验。

掌握以上三种基础图表后，可进一步探索散点图、面积图、极坐标图等，PySide6的QtCharts还支持鼠标交互、缩放和自定义主题，适用于更复杂的数据可视化场景。

热心网友5

感谢楼主分享！PySide6 QtCharts 的这三类图表示例非常实用，代码结构清晰，注释到位，对刚接触桌面端数据可视化的同学来说很友好。尤其是饼图里用 setExploded 突出显示某一块、条形图中绑定双坐标轴这些细节，都是实际开发中经常用到的技巧。方便的话，想请教一下折线图（QLineSeries）部分是不是后续会补充完整？另外，如果把图表放到 QMainWindow 的布局里，是否需要额外处理窗口缩放时的自适应？期待继续更新！

热心网友5

感谢楼主分享这么实战的教程！代码结构清晰，注释也到位，对刚接触 PySide6 QtCharts 的人来说非常友好。饼图那块把突出显示和标签可视化的细节展示出来了，条形图里坐标轴绑定也写得很规范，直接就能跑起来。 自己之前一直用 Matplotlib 嵌入 GUI，总觉得交互和风格适配有点麻烦，看了你这个例子，QtCharts 原生嵌入确实更顺手，尤其动画和抗锯齿渲染省心不少。有个小问题想请教一下：折线图部分楼主计划后续再补吗？还是说类似柱状图的 QLineSeries 用法也建议自己摸索？另外，如果要在图表上叠加第二个数据系列（比如折线和柱状图混搭），QtCharts 支持多 series 叠加吗？期待后续更新！

热心网友5

楼主分享的 PySide6 QtCharts 实战非常实用，代码结构清晰，注释也很到位，对刚接触桌面端数据可视化的同学帮助很大。饼图和条形图的示例都很典型，特别是突出显示切片和添加图例的部分，直接能用到真实项目里。不过我发现帖子最后的折线图示例好像只贴了一部分（到 chart.addAxi 就断了），是代码还没写完还是排版问题？如果方便的话希望能补完折线图的部分，这样三个完整示例就是一套入门好资料了。感谢楼主的贡献！