PyQt5搭配PyFluidSynth实现QPushButton按键发声时报FluidSynth库缺失的ImportError

当前触发的ImportError: Couldn't find the FluidSynth library，并非pip安装的Python绑定包缺失——从报错栈可以看到，程序已经加载到本地site-packages目录下的pyfluidsynth.py文件，说明Python侧的封装层已经安装完成，报错原因是这个封装层在运行时找不到系统层面安装的FluidSynth核心动态链接库。

关于你提到的pyfluidsynth和fluidsynth模块的差异：

• 旧版第三方单文件封装的pyfluidsynth包，加载时会主动扫描系统路径查找FluidSynth动态库，找不到就抛出当前的导入错误，API设计比较老旧
• 官方维护的fluidsynthPython绑定包，和前者接口兼容，安装时会自动匹配系统库路径，不会出现这类扫描失败的导入问题，二者属于同生态下不同维护方的实现，并非同一个模块

• 第一步：安装系统级FluidSynth核心依赖
  • 你当前运行环境是macOS（报错路径为~/Library下的Python3.7目录），直接在终端执行brew install fluidsynth安装系统级核心库即可
  • Windows环境需要手动放置FluidSynth的dll文件到系统可识别的PATH路径下
  • Debian/Ubuntu类Linux环境，在终端执行sudo apt install fluidsynth libfluidsynth-dev完成安装
• 第二步：替换Python侧绑定包，避免封装层的扫描报错
  先在终端执行pip uninstall pyfluidsynth && pip install fluidsynth，把旧的第三方封装包替换为官方维护的绑定包，再把原有代码里的import pyfluidsynth替换为import fluidsynth as pyfluidsynth，即可无缝兼容原有写好的调用逻辑，不需要修改后续的Synth初始化、音效播放的代码
• 第三步：优化原有代码的运行逻辑，避免界面卡顿
  原代码存在两处影响运行体验的问题：
  • 把Synth实例初始化、Soundfont加载逻辑写在按钮点击槽函数内，每次点击都要重复初始化音频引擎，增加响应延迟
  • 槽函数内使用time.sleep(1.0)做音符延时，会直接阻塞PyQt主线程，导致界面卡死
    调整思路：把Synth实例创建、Soundfont加载的逻辑挪到全局/窗口初始化阶段完成，音符延时通过Qt非阻塞定时器实现，不要用阻塞式sleep

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QPushButton
from PyQt5.QtCore import pyqtSlot, QTimer
import fluidsynth

# 全局初始化音频引擎，避免重复创建
fs = fluidsynth.Synth()
fs.start()
sfid = fs.sfload("acoustic_grand_piano_ydp_20080910.sf2")
fs.program_select(0, sfid, 0, 0)

class App(QWidget):

    def __init__(self):
        super().__init__()
        self.title = 'PyQt5 button - pythonspot.com'
        self.left = 10
        self.top = 10
        self.width = 320
        self.height = 200
        self.initUI()

    def initUI(self):
        self.setWindowTitle(self.title)
        self.setGeometry(self.left, self.top, self.width, self.height)

        button = QPushButton('PyQt5 button', self)
        button.setToolTip('This is an example button')
        button.move(100, 70)
        button.clicked.connect(self.PlayNote)

        self.show()

    def PlayNote(self):
        # 直接触发音符发声
        fs.noteon(0, 60, 30)
        # 用非阻塞定时器延时关闭音符，避免卡主线程
        QTimer.singleShot(1000, lambda: fs.noteoff(0, 60))


if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = App()
    sys.exit(app.exec_())

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