如何解决QGraphicsLineItem分段线条渐隐时的连接点重叠问题？

你遇到的线条连接点重叠问题，核心原因是每个QGraphicsLineItem是独立的线段对象：相邻线段共享端点，加上笔宽存在，当设置不同透明度时，两个线段的端点区域会重叠叠加，透明度混合后形成视觉上的突兀凸起；另外你处理单点的强制偏移逻辑，也会引入微小的无效线段，加剧重叠问题。

方案一：使用QGraphicsPathItem绘制连续路径（推荐） #

将所有线段合并为单个连续路径，彻底消除独立线段的端点重叠问题，同时通过渐变画笔实现自然的尾部渐隐效果。

代码实现

首先在类初始化时创建路径和路径项：

def __init__(self, parent=None):
    super().__init__(parent)
    self.path = pg.QtGui.QPainterPath()
    self.path_item = pg.QtWidgets.QGraphicsPathItem()
    self.addItem(self.path_item)
    self.points_history = []  # 存储历史坐标，控制路径长度与渐隐范围

修改drawLine1方法，动态更新路径并设置渐变画笔：

def drawLine1(self, x, y, z):
    current_point = pg.QtCore.QPointF(x[-1], y[-1])
    self.points_history.append(current_point)

    # 初始化或追加路径段
    if len(self.points_history) == 1:
        self.path.moveTo(current_point)
    else:
        # 跳过重合点，避免无效线段
        if self.points_history[-2] != current_point:
            self.path.lineTo(current_point)

    # 控制路径最大长度
    max_points = 50
    fade_start_idx = 40  # 从第40个点开始渐隐
    if len(self.points_history) > max_points:
        self.points_history.pop(0)
        # 重建路径
        self.path = pg.QtGui.QPainterPath()
        self.path.moveTo(self.points_history[0])
        for p in self.points_history[1:]:
            self.path.lineTo(p)

    # 创建线性渐变画笔
    pen_width = z + ModeOne.pen_wid_1
    base_color = ModeOne.color_1
    gradient = pg.QtGui.QLinearGradient()
    gradient.setStart(self.points_history[0])
    gradient.setFinalStop(self.points_history[-1])

    # 前半段保持完全不透明，后半段逐渐透明
    fade_ratio = fade_start_idx / len(self.points_history) if self.points_history else 0
    gradient.setColorAt(0, base_color)
    gradient.setColorAt(fade_ratio, base_color)
    gradient.setColorAt(1, base_color.withAlpha(0))

    # 设置笔的样式，优化连接效果
    pen = pg.QtGui.QPen(gradient, pen_width)
    pen.setCapStyle(pg.QtCore.Qt.RoundCap)
    pen.setJoinStyle(pg.QtCore.Qt.RoundJoin)
    
    self.path_item.setPen(pen)
    self.path_item.setPath(self.path)

方案二：修复独立QGraphicsLineItem的重叠问题 #

如果坚持使用多个独立线段，可通过调整笔样式和透明度逻辑减少重叠：

1. 优化笔帽样式，避免端点超出坐标范围
2. 平滑透明度过渡，减少相邻线段的透明度差异
3. 跳过重合点，避免无效微小线段

代码修改

def drawLine1(self,x,y,z):
    # 跳过重合点，不绘制无效线段
    if len(x)>=2 and x[-2]==x[-1] and y[-2]==y[-1]:
        return
        
    item = pg.QtWidgets.QGraphicsLineItem()
    # 设置FlatCap，让线段端点严格对齐坐标
    pen = pg.mkPen(
        width= z+ ModeOne.pen_wid_1, 
        color= ModeOne.color_1,
        cap=pg.QtCore.Qt.FlatCap,
        join=pg.QtCore.Qt.MiterJoin
    )
    item.setPen(pen)
    item.setLine(x[-2],y[-2],x[-1],y[-1])
  
    self.addItem(item)
    self.rectdata_fir.append(item)
    self.disappear_item(self.rectdata_fir)

def disappear_item(self, item_list):
    if len(item_list)>50:
        # 线性平滑过渡透明度，减少叠加差异
        for idx in range(1,11):
            opacity = 0.11 - (idx * 0.01)
            item_list[idx].setOpacity(opacity)
        self.removeItem(item_list.pop(0))

• 方案一的连续路径模式，视觉效果最流畅，彻底解决重叠问题，是优先推荐的实现方式。
• 方案二仅能缓解重叠问题，本质还是多个独立对象，仍可能存在细微的视觉断层。

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