PyQt5结合matplotlib更新绘图时残留旧坐标轴数据的问题

问题核心原因 #

加载新FASTA文件绘图时出现新旧数据混叠，本质是绘图流程未做旧内容清理：

• 原代码在get_plot()方法中每次都通过self.canvas.figure.subplots()获取绘图坐标轴，该方法在已有绘图内容的画布上重复调用时，不会自动移除之前绘制的柱形、坐标轴刻度等元素，只会在原有图层上叠加新的绘图内容
• 未主动重置坐标轴的刻度范围、清空缓存的旧数据点，最终表现为新旧柱形、新旧轴刻度混合显示，出现冗余旧数据点

解决方法 #

调整逻辑为初始化阶段固定画布与坐标轴对象，每次绘图前主动清空轴内容，绘制完成后触发画布刷新，具体修改点如下：

• 初始化画布阶段提前创建固定的Axes绘图对象，避免每次绘图时重复生成子图层：

  # 在visualize()方法中，初始化canvas时同步固定ax对象
  self.canvas = FigureCanvas(plt.Figure(figsize=(10, 4)))
  self.ax = self.canvas.figure.subplots()
  

• 改造get_plot()方法的绘图流程，加入清空和刷新逻辑：

  def get_plot(self):
      filepath, _ = QFileDialog.getOpenFileName(self, 'select FASTA file')
      # 增加空路径判断，避免用户取消选择文件时触发读取异常
      if not filepath:
          return
      record = SeqIO.read(filepath,"fasta")
      
      dna = record.seq
      mrna = dna.transcribe()
      protein = mrna.translate()
      
      self.mol_weight = molecular_weight(dna)
      
      gc = GC(dna)
      self.gc_count_field.setText(str(gc))
      
      pr_freq = Counter(protein)
      
      # 核心操作：清空当前坐标轴的所有旧绘图元素、旧刻度
      self.ax.cla()
      # 绘制新的柱状图
      self.ax.bar(pr_freq.keys(), pr_freq.values())
      self.ax.set_title("Amino Acid Contents in the sequence (X-axis Amino acids, Y-axis frequency)")
      # 核心操作：触发画布重绘，让更新内容即时显示
      self.canvas.draw()
  

常见踩坑提示 #

• 不要在每次绘图时重复调用figure.subplots()，该方法会在同一个Figure上不断叠加新的Axes图层，长期使用会导致画布内存占用升高、图层残留越来越严重
• 绘制完新内容后必须调用self.canvas.draw()，Qt端的Matplotlib画布不会自动感知Axes的内容变化，缺少这个调用会出现画布缓存不刷新、仍显示旧绘图内容的问题

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