PyQt5自定义可点击QLabel点击后程序异常退出问题排查

你遇到的退出码-1073740791是Windows平台典型的C++层非法内存访问错误，Python解释器无法捕获这类底层错误，因此控制台不会输出Python调用栈信息。直接触发崩溃的原因是参数类型传递错误：

• 自定义ClickableQLabel在鼠标点击触发回调时，传入的是QMouseEvent类型的事件对象
• 但move_tile方法里直接把这个事件对象当成整数下标，去索引self.gameTiles列表，直接触发底层内存越界访问，程序立刻崩溃。

除了直接导致崩溃的问题，还有两个隐藏逻辑bug会导致后续看不到方块移动效果：

• 加入QGridLayout的控件位置完全由布局管理器接管，直接修改控件pos属性做动画，会被布局立刻重置回原位置，看不到移动过程
• 实例化ClickableQLabel时没有传入父对象，可能被Python垃圾回收机制提前回收，触发随机崩溃。

1. 修正自定义可点击标签的回调逻辑 #

点击触发时将标签自身作为参数传给回调，同时保留父类事件传播逻辑，避免事件被意外吞掉：

class ClickableQLabel(QLabel):
    def __init__(self, when_clicked, parent=None):
        super().__init__(parent)
        self._when_clicked = when_clicked

    def mousePressEvent(self, ev):
        super().mousePressEvent(ev)
        if self._when_clicked:
            self._when_clicked(self)

2. 修正移动方法的参数处理 #

直接接收被点击的控件对象，原型测试阶段临时将控件从布局中取出再执行动画，避免被布局管理器重置位置：

def move_tile(self, clicked_tile):
    # 原型阶段临时测试动画用，正式开发需要结合空白格坐标计算目标位置
    self.layout().removeWidget(clicked_tile)
    clicked_tile.setParent(self)
    clicked_tile.move(0, 0) # 设置动画起始位置，避免跳变
    clicked_tile.anim = QPropertyAnimation(clicked_tile, b"pos")
    clicked_tile.anim.setEndValue(QPoint(220, 221))
    clicked_tile.anim.setDuration(200)
    clicked_tile.anim.start()

3. 补全控件初始化参数 #

实例化标签时传入父对象，避免对象被意外回收：

num_label = ClickableQLabel(self.move_tile, parent=self)

import sys
import random
from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QGridLayout
from PyQt5.QtGui import QPixmap
from PyQt5.QtCore import QPropertyAnimation, QPoint

class ClickableQLabel(QLabel):
    def __init__(self, when_clicked, parent=None):
        super().__init__(parent)
        self._when_clicked = when_clicked

    def mousePressEvent(self, ev):
        super().mousePressEvent(ev)
        if self._when_clicked:
            self._when_clicked(self)

class NewGame(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Number Slide Game")
        self.resize(300, 300)
        self.gameTiles = []

        for tile_no in range(0, 15):
            tile_no_img_num = tile_no + 1
            num_img = QPixmap(f'images/numTile{tile_no_img_num}.png')
            num_label = ClickableQLabel(self.move_tile, parent=self)
            num_label.setPixmap(num_img)
            # 无测试图片时可打开下方注释用文字代替
            # num_label.setText(str(tile_no_img_num))
            # num_label.setStyleSheet("border:1px solid #333; padding:20px;")
            self.gameTiles.append(num_label)

        random.shuffle(self.gameTiles)

        game_layout = QGridLayout()
        game_layout.setHorizontalSpacing(0)
        game_layout.setVerticalSpacing(0)

        tile_num = 0
        for rowNum in range(0, 4):
            for colNum in range(0, 4):
                if tile_num < 15:
                    game_layout.addWidget(self.gameTiles[tile_num], rowNum, colNum)
                    tile_num += 1

        self.setLayout(game_layout)

    def move_tile(self, clicked_tile):
        self.layout().removeWidget(clicked_tile)
        clicked_tile.setParent(self)
        clicked_tile.move(0, 0)
        clicked_tile.anim = QPropertyAnimation(clicked_tile, b"pos")
        clicked_tile.anim.setEndValue(QPoint(220, 221))
        clicked_tile.anim.setDuration(200)
        clicked_tile.anim.start()

if __name__ == "__main__":
    app = QApplication(sys.argv)
    gameWindow = NewGame()
    gameWindow.show()
    sys.exit(app.exec_())

• 正式实现游戏逻辑时，建议单独维护空白格的行列坐标，点击方块时先判断是否和空白格相邻，再计算目标坐标执行移动
• 如果要保留布局自动对齐能力，可以在动画结束后调用布局的addWidget方法把控件放回对应位置，不要长期混用绝对位置和布局管理
• 所有QObject派生类实例化时尽量传入父对象，避免Python垃圾回收提前回收对象触发底层崩溃

内容的提问来源于stack exchange，提问作者J-muns