如何优化Python原生DLL封装库的项目结构，使PyInstaller自动识别并打包依赖的DLL？

我完全懂你的痛点——做封装库就是为了让用户不用关心底层的DLL细节，结果PyInstaller打包还要额外加参数，确实有点违背初衷。这里有几个方案能让你的库自动被PyInstaller识别，不用用户手动操作：

方案一：给库添加PyInstaller钩子文件（推荐） #

这是PyInstaller官方推荐的第三方库适配方式，本质是提前告诉PyInstaller“这个库需要打包哪些额外资源”，用户打包时完全不用额外参数。具体步骤如下：

1. 调整项目结构，新增hooks目录存放钩子文件：

wrapper
|-- wrapper
|   |-- __init__.py
|   |-- mylib.dll
|   |-- hooks
|       |-- hook-wrapper.py
|-- pyproject.toml

2. 编写钩子文件 hook-wrapper.py，内容如下：

from PyInstaller.utils.hooks import collect_dynamic_libs

# 收集wrapper库下的所有动态链接库
datas = collect_dynamic_libs('wrapper')

3. 修改pyproject.toml，确保钩子文件被包含到包中：
   在[tool.poetry]区块下添加：

include = [
    "wrapper/hooks/*.py"
]

这样用户安装你的库后，PyInstaller会自动找到这个钩子文件，自动收集DLL资源，打包时不需要加任何额外参数，和使用纯Python库完全一致。

方案二：声明Package Data（备选） #

你也可以通过Poetry的package-data配置标记DLL为需要打包的资源，不过这个方案的可靠性略低于钩子：

修改pyproject.toml，添加：

[tool.poetry.package-data]
"wrapper" = ["*.dll"]

这个配置会告诉Poetry把DLL作为包的一部分安装到用户环境，但PyInstaller对这种静态声明的资源识别稳定性不如专门的钩子文件，所以还是优先推荐方案一。

关于你发现的--collect-binaries参数 #

你提到的pyinstaller --collect-binaries wrapper ./main.py确实能解决问题，但它是让用户手动触发PyInstaller的二进制收集逻辑；而钩子方案相当于把这个逻辑内置到你的库中，用户完全感知不到底层的DLL存在，更符合封装库的设计初衷。

验证方法 #

修改完成后，重新执行poetry build生成新的wheel包，用pip install安装后，直接运行pyinstaller ./main.py，此时PyInstaller应该会自动识别并打包mylib.dll，不会再出现PyInstallerImportError。

备注：内容来源于stack exchange，提问作者Dune