如何实现PyQt5 QtChart在切换年份下拉框时自动刷新数据

核心逻辑是初始化时一次性创建图表的基础结构（图表实例、序列、坐标轴），切换年份时仅更新数据和轴的分类属性，无需重建整个图表。

前置准备 #

将图表核心组件定义为类的成员变量，避免局部变量无法复用：

• QChart 实例：图表容器
• QBarSeries/QBarSet 实例：柱状图数据载体
• QBarCategoryAxis 实例：X轴（月份分类轴）
• QValueAxis 实例：Y轴（统计值数值轴）

初始化阶段一次性创建图表基础结构 #

在UI初始化完成后调用一次即可，无需在下拉框切换时重复执行：

from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QMainWindow
from PyQt5.QtChart import QChart, QBarSeries, QBarSet, QBarCategoryAxis, QValueAxis
# 替换为自己的QtDesigner生成的UI类名
from ui_main import Ui_MainWindow

class MainWindow(QMainWindow, Ui_MainWindow):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setupUi(self)

        # 初始化图表基础结构
        self.stat_chart = QChart()
        self.stat_chart.setTitle("月度业务统计")
        # 初始化柱状数据集
        self.stat_bar_set = QBarSet("业务量")
        # 初始化柱状序列
        self.stat_series = QBarSeries()
        self.stat_series.append(self.stat_bar_set)
        self.stat_chart.addSeries(self.stat_series)

        # 初始化X轴（月份分类轴）
        self.axis_x = QBarCategoryAxis()
        self.stat_chart.addAxis(self.axis_x, Qt.AlignBottom)
        self.stat_series.attachAxis(self.axis_x)
        # 初始化Y轴（数值轴）
        self.axis_y = QValueAxis()
        self.stat_chart.addAxis(self.axis_y, Qt.AlignLeft)
        self.stat_series.attachAxis(self.axis_y)

        # 绑定图表到UI中的QChartView控件，替换为你自己的控件名
        self.chartView.setChart(self.stat_chart)

        # 绑定年份下拉框切换信号到更新方法，替换为你自己的下拉框控件名
        self.year_combo.currentTextChanged.connect(self.update_chart_one)
        # 首次加载默认选中年份的数据
        self.update_chart_one(self.year_combo.currentText())

update_chart_one 方法实现 #

切换年份时仅更新数据和轴属性，性能远高于重建图表：

def update_chart_one(self, selected_year):
    # 清空上一个年份的旧数据
    self.stat_bar_set.remove(0, self.stat_bar_set.count())

    # 从你的数据源获取对应年份的月度数据，替换为自己的取数逻辑
    # 示例返回值：第一个元素是月份列表，第二个是对应统计值列表
    # 例如 (["1月", "2月", ..., "12月"], [230, 456, ..., 321])
    month_list, stat_data = self.get_year_stat_data(selected_year)

    # 填充新数据到柱状数据集
    for value in stat_data:
        self.stat_bar_set.append(value)

    # 更新X轴月份分类（如果固定12个月无缺省可省略该步骤）
    self.axis_x.clear()
    self.axis_x.append(month_list)

    # 动态调整Y轴显示范围，留10%顶部余量避免数据贴边
    if stat_data:
        max_value = max(stat_data)
        self.axis_y.setRange(0, max_value * 1.1)
    else:
        # 无数据时的默认Y轴范围
        self.axis_y.setRange(0, 1)

注意事项 #

• 不要在更新方法中重复创建QChart、序列、轴实例，否则和原有重建图表的逻辑无差异，还会造成内存泄漏
• 如果月度数据固定为12个自然月无缺省，可以跳过X轴分类更新的步骤，仅更新Y轴数据即可，性能更高
• 如下拉框的年份值为数字类型，注意将信号传入的字符串参数转为对应数字类型后再查询数据

内容的提问来源于stack exchange，提问作者David Dan