PyQt5 使用 pyqtgraph 时如何避免轴超出组件边界、修复显示异常问题

• 坐标轴超出组件边界、刻度被截断：一是UI中使用绝对坐标硬写布局容器位置，没有让布局随窗口自适应拉伸，导致pyqtgraph组件的尺寸计算偏差；二是PlotWidget默认未预留足够的内部边距，坐标轴、刻度文字会贴靠组件边缘被裁切。
• 设置标题后不显示：误用了setWindowTitle()接口，该接口用于设置顶层窗口的标题栏文字，和PlotWidget内部渲染的图表标题无关联，属于方法调用错误。

1. 修正图表标题设置逻辑 #

• 替换错误的setWindowTitle()调用，改用PlotItem内置的setTitle()方法设置图表内部显示的标题，配合全局黑背景样式指定文字颜色为白色，避免黑底白字不可见的问题。
• 标题的位置、字体大小可通过方法参数直接配置，匹配组件内部预留的边距空间。

2. 解决坐标轴截断问题 #

• 重构UI布局逻辑：删除原有布局容器的硬编码绝对坐标，将承载两个PlotWidget的水平布局直接设为centralwidget的顶级布局，让组件随窗口大小自动调整尺寸，不再固定渲染区域。所有硬编码的固定坐标都会破坏PyQt的布局尺寸计算逻辑，是导致坐标轴溢出的核心原因。
• 给每个PlotWidget对应的PlotItem配置内部边距，为坐标轴刻度、标题文字预留足够的渲染空间，避免内容贴靠组件边界被裁切。
• 配置ViewBox的默认内边距，匹配布局的实际渲染区域，修正尺寸计算偏差。

3. 匹配业务需求的专项配置 #

• 左侧speed图表：开启Y轴自动范围适配，实现数据更新时Y轴动态缩放匹配当前数据范围，无需硬写固定坐标区间。
• 右侧position图表：按照61m×121m的物理范围锁定X、Y轴坐标区间，取消默认的范围扩展padding，让图表边界和物理区域完全对齐。

from PyQt5 import QtWidgets, uic
import pyqtgraph as pg
import sys
import numpy as np

# 全局配置pyqtgraph样式适配黑底界面
pg.setConfigOption('background', 'k')
pg.setConfigOption('foreground', 'w')

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self, *args, **kwargs):
        super(MainWindow, self).__init__(*args, **kwargs)
        uic.loadUi('mainwindow.ui', self)
        
        # Position图表配置
        pos_plot = self.position.getPlotItem()
        pos_plot.setTitle("Position", size="12pt")
        # 锁定物理范围对应的坐标边界，取消默认扩展padding
        pos_plot.setXRange(0, 61, padding=0)
        pos_plot.setYRange(0, 121, padding=0)
        # 预留内部边距，避免内容被截断
        pos_plot.setContentsMargins(25, 35, 25, 15)
        pos_plot.getViewBox().setDefaultPadding(0.02)

        # Speed图表配置
        speed_plot = self.speed.getPlotItem()
        speed_plot.setTitle("Speed", size="12pt")
        speed_plot.setContentsMargins(25, 35, 25, 15)
        # 开启Y轴动态自适应
        speed_plot.enableAutoRange(axis='y', enable=True)
        speed_plot.setAutoVisible(y=True)

    def plot_test(self):
        x = np.linspace(0, 60, 100)
        speed_data = np.random.normal(5, 2, 100)
        pos_data = np.linspace(0, 120, 100)
        self.speed.plot(x, speed_data, pen='r')
        self.position.plot(x, pos_data, pen='g')

def main():
    app = QtWidgets.QApplication(sys.argv)
    main = MainWindow()
    main.plot_test()
    main.show()
    sys.exit(app.exec_())

if __name__ == '__main__':         
    main()

• 删除horizontalLayoutWidget节点下所有硬编码的geometry属性值，将该布局容器直接挂载为centralwidget的顶级布局，取消所有固定坐标设置，让布局随窗口拉伸自动撑满整个中央区域。
• 修正customwidget声明，确保PlotWidget的头文件路径指向pyqtgraph.PlotWidget，避免组件尺寸计算异常。

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