[Pyinstaller] ModuleNotFoundError: No module named 'xxx' 手动添加依赖

假设我需要打包使用 Playwright 的脚本至exe，打包完成后提示 缺少某某模块，可以通过以下两种方法添加。在此使用 Playwright 包进行演示。

1. 全局配置 - 添加HOOK

通过以下路径进入到Pyinstaller的hooks目录下

%PYTHON_PATH% \Lib\site-packages\PyInstaller\hooks

可以发现这里存放着一些常用的包hook，例如 django，pyqt 之类的。打包时即使不在spec文件中标注引用这些依赖，pyinstaller也会自动从该文件夹内查询并自动引用。因此你经常需要打包的第三方包可以在这里通过hooks文件的方式实现全局引用。

在当前文件夹创建 hook-playwright ，照着其他文件写入以下内容：

from PyInstaller.utils.hooks import collect_data_files, collect_submodules
 
datas = collect_data_files('playwright')
hiddenimports = collect_submodules('playwright')

保存后重新执行打包

2. 局部配置 - 修改SPEC文件

如果不是经常用的包，或环境较为复杂的情况下想要单独区分打包的依赖，可以通过spec文件配置。

该文件你可以自己编写，或者通过命令行配置参数后自动生成。

打开该文件找到 a = Analysis({...}) 内的 hiddenimports，在其列表内加入你想要添加的依赖名即可。

以下是参考模板：

# -*- mode: python ; coding: utf-8 -*-


a = Analysis(
    ['D:\\MyPack\\client.py'],
    pathex=[],
    binaries=[],
    datas=[],
    hiddenimports=['playwright'],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],
    noarchive=False,
    optimize=0,
)
pyz = PYZ(a.pure)

exe = EXE(
    pyz,
    a.scripts,
    a.binaries,
    a.datas,
    [],
    name='打包测试',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,
    upx_exclude=[],
    runtime_tmpdir=None,
    console=False,
    disable_windowed_traceback=False,
    argv_emulation=False,
    target_arch=None,
    codesign_identity=None,
    entitlements_file=None,
    icon=[],
)