PyQt5资源文件或导入故障：pyrcc5转换后拨号音无法播放

核心错误点 #

你代码里加载音频资源的QUrl用法错误：QUrl.fromLocalFile()仅用于解析本地磁盘的真实文件路径，而你传入的:/dtmf/xxx.wav是Qt资源系统内嵌的虚拟路径，用这个方法解析后无法正确定位资源，自然播放不出声音。

分步排查 #

• 第一步：先验证资源是否正常加载
  在MainWindow初始化时加一行校验代码，确认你自己生成的资源文件是否正确打包了音频：

# 加在dialpad初始化之前即可
print("1号键音频资源是否存在：", qtc.QFile.exists(':/dtmf/1.wav'))

运行后如果控制台输出False，说明你写的qrc文件配置有误，检查两个配置项：

• qrc文件中<qresource>标签的prefix属性必须是/dtmf，和代码里的路径前缀一致
• qrc中列出的每个音频文件名必须和实际文件名、代码里的文件名完全一致，包括后缀大小写（Qt资源系统严格区分大小写，和操作系统的文件大小写规则无关）

参考正确的qrc文件格式：

<RCC>
    <qresource prefix="/dtmf">
        <file>0.wav</file>
        <file>1.wav</file>
        <file>2.wav</file>
        <file>3.wav</file>
        <file>4.wav</file>
        <file>5.wav</file>
        <file>6.wav</file>
        <file>7.wav</file>
        <file>8.wav</file>
        <file>9.wav</file>
        <file>*.wav</file>
        <file>#.wav</file>
    </qresource>
</RCC>

确认qrc配置正确后，重新执行pyrcc5转换命令：pyrcc5 你的qrc文件名.qrc -o resources1.py，保证输出的py文件名和代码里import resources1的导入名一致。

• 第二步：修正QUrl加载方式
  如果第一步校验输出True，说明资源本身打包没问题，只需要修改SoundButton类里的资源加载代码，把fromLocalFile换成qrc协议的URL构造方式即可：

class SoundButton(qtw.QPushButton):

    def __init__(self, wav_file, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.wav_file = wav_file
        self.player = qtmm.QSoundEffect()
        # 内嵌qrc资源需要用qrc://协议路径，不能用fromLocalFile
        self.player.setSource(qtc.QUrl(f"qrc{wav_file}"))
        self.clicked.connect(self.player.play)

原因说明 #

你本地测试音频的时候用的是磁盘真实路径，fromLocalFile可以正常解析；换成内嵌资源路径后，资源已经被打包进py文件，不存在于本地磁盘，必须用Qt规定的qrc协议格式访问，这也是为什么教程提供的resources.py能正常运行——教程代码里的资源加载写法本身是正确的。

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