如何用PyInstaller的--hidden-import一次性导入所有子模块？

PyInstaller的--hidden-import参数不会自动递归导入父模块下的所有子模块，所以只指定--hidden-import module无法识别未被父模块显式导入的子模块。以下是几种批量导入的可行方法：

方法一：使用.spec文件（推荐） #

这是最灵活且可靠的方式，步骤如下：

1. 生成脚本对应的.spec文件：

   pyi-makespec your_main_script.py
   

2. 编辑生成的.spec文件，找到hiddenimports列表：
   • 手动添加子模块：直接列出所有需要隐藏导入的子模块：

     hiddenimports = ['module.submodule1', 'module.submodule2', 'module.submodule3']
     

   • 自动收集子模块：如果子模块数量多且可能变动，可以在.spec文件中加入一段Python代码自动遍历收集：

     import pkgutil
     import module
     
     hiddenimports = []
     # 遍历一级子模块
     for _, submodule_name, is_pkg in pkgutil.iter_modules(module.__path__):
         full_submodule = f"{module.__name__}.{submodule_name}"
         hiddenimports.append(full_submodule)
         # 递归收集子模块的子模块（如果是包的话）
         if is_pkg:
             sub_pkg = __import__(full_submodule, fromlist=[''])
             for _, sub_submodule, _ in pkgutil.iter_modules(sub_pkg.__path__):
                 hiddenimports.append(f"{full_submodule}.{sub_submodule}")
     

3. 用.spec文件打包：

   pyinstaller your_main_script.spec
   

方法二：命令行通配符（依赖Shell支持） #

在支持通配符扩展的Shell（如Bash、Zsh）中，可以用通配符一次性指定所有子模块：

pyinstaller --hidden-import 'module.submodule*' your_main_script.py

注意：部分Shell可能需要用单引号包裹通配符，避免提前被Shell解析。这种方法适合子模块命名有规律的场景，但如果子模块层级较深，通配符可能无法覆盖所有层级。

为什么--hidden-import module不生效？ #

PyInstaller只会解析指定模块本身的代码，不会主动遍历其目录下的所有子模块。只有当父模块的__init__.py中显式导入了子模块时，PyInstaller才会自动包含这些子模块；如果子模块是"隐藏"的（即父模块未导入），必须单独指定每个子模块的路径。

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