如何使用PyInstaller正确打包基于pyqtlet2的Linux Python程序？

pyqtlet2依赖内嵌的Leaflet JS库、CSS及静态资源文件，PyInstaller默认不会自动识别这类非Python代码资源，导致打包后缺失文件运行失败。以下是几种可靠的解决方法：

方法一：修改.spec文件（推荐，可控性强） #

1. 生成默认的.spec配置文件：

   pyi-makespec your_main_script.py
   

2. 打开生成的.spec文件，找到datas列表，添加pyqtlet2的资源路径。先定位你的pyqtlet2安装目录（Linux下通常在虚拟环境的lib/pythonX.X/site-packages/pyqtlet2或系统级的/usr/local/lib/pythonX.X/site-packages/pyqtlet2），然后将资源映射添加到datas：

   datas=[
       # 格式：(源文件/目录路径, 打包后目标路径)
       ('/实际路径/pyqtlet2/leaflet', 'pyqtlet2/leaflet'),
       ('/实际路径/pyqtlet2/*.js', 'pyqtlet2'),
       ('/实际路径/pyqtlet2/*.css', 'pyqtlet2'),
   ]
   

3. 用修改后的.spec文件重新打包：

   pyinstaller your_main_script.spec
   

方法二：自定义PyInstaller Hook（适合长期复用） #

1. 在项目根目录创建hook-pyqtlet2.py文件，内容如下：

   from PyInstaller.utils.hooks import collect_data_files
   # 收集pyqtlet2的所有非Python资源文件
   datas = collect_data_files('pyqtlet2', include_py_files=False)
   

2. 打包时指定hook目录：

   pyinstaller --additional-hooks-dir=. your_main_script.py
   

   或者将该hook文件复制到PyInstaller的默认hooks目录（如虚拟环境下的lib/pythonX.X/site-packages/PyInstaller/hooks），后续打包无需再指定参数。

方法三：手动复制资源（临时应急方案） #

打包完成后，找到pyqtlet2安装目录下的leaflet文件夹、.js和.css文件，手动复制到dist/你的应用名/pyqtlet2/目录下，确保目录结构与原安装目录一致。

额外注意事项 #

• 代码中避免硬编码pyqtlet2资源的绝对路径，建议使用importlib.resources动态获取路径：

  from importlib.resources import files
  # 获取pyqtlet2资源根目录
  pyqtlet_resources = files('pyqtlet2')
  

• 打包后检查dist/你的应用名/pyqtlet2/目录，确认包含leaflet文件夹、leaflet.js、leaflet.css等核心文件，再运行程序验证。

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