在Python项目开发中，有时为了提高代码的运行效率或保护源代码，我们会将部分.py文件编译成.pyd文件（Python动态链接库）。然而，当使用PyInstaller将原本调用这些.pyd文件的Python脚本打包为可执行文件时，可能会遇到“找不到**模块”（“No module named…”）的报错。本文将从几个方面分析这一问题的成因，并提供相应的解决方法。（注：下面方法也可用于帮助解决pyinstaller编译脚本后可能出现的其他很多无法找到文件的情况）
问题成因
1. PyInstaller无法自动识别.pyd文件：PyInstaller在分析Python脚本的依赖关系时，主要通过静态分析和运行时跟踪来确定需要包含的模块。对于直接编译成.pyd文件的模块，PyInstaller可能无法自动识别其存在，从而导致打包后的可执行文件在运行时无法找到相应的模块。
2. 模块路径问题：即使PyInstaller识别到了.pyd文件，但如果在打包过程中模块的路径信息没有正确处理，运行时也会出现找不到模块的错误。这可能是因为.pyd文件的路径在打包后发生了变化，而Python解释器在运行时无法在正确的位置找到该模块。
常用解决方法
1. 使用--hidden-import选项
如果PyInstaller无法自动识别某个.pyd模块，可以在打包时使用--hidden-import选项显式指定需要包含的模块。例如，假设你的.pyd文件名为your_module.pyd，可以使用以下命令进行打包：
pyinstaller --onefile --hidden-import=your_module.pyd your_script.py这里your_script.py是原本调用*.pyd文件的Python脚本。通过--hidden-import选项，PyInstaller会在打包时将your_module模块包含进去，从而避免运行时报错。（上面展示了使用--hidden-import选项添加一个需要包含的文件/模块的用法）
如果需要指定多个模块/文件可以通过以下方法实现：
方法 1：多次使用 --hidden-import
你可以多次使用 --hidden-import 参数，分别指定每个需要包含的模块。例如：
pyinstaller --onefile \
--hidden-import=your_module1 \
--hidden-import=your_module2 \
--hidden-import=package.submodule \
your_script.py（这种方式适用于模块数量较少的情况）
方法 2：使用 .spec 文件手动指定
如果模块较多，或者需要更灵活的配置，可以使用 .spec 文件手动指定需要包含的模块。
①生成 .spec 文件
首先运行 PyInstaller 生成 .spec 文件（不进行打包）：
pyinstaller your_script.py这会在当前目录下生成一个 your_script.spec 文件。
②编辑 .spec 文件
打开生成的 .spec 文件，找到 Analysis 对象的 hiddenimports 列表。将需要包含的模块添加到该列表中。例如：
a = Analysis(['your_script.py'],
...
hiddenimports=['your_module1', 'your_module2', 'package.submodule'],
...)③使用 .spec 文件打包
保存并关闭 .spec 文件后，使用该文件进行打包：
pyinstaller your_script.spec
方法 3：使用 --paths 参数指定模块路径
如果模块位于不同的路径下，可以通过 --paths 参数指定额外的模块搜索路径。例如：
pyinstaller --onefile \
--paths=/path/to/module1 \
--paths=/path/to/module2 \
--hidden-import=your_module1 \
--hidden-import=your_module2 \
your_script.py--paths 参数会告诉 PyInstaller 在指定的路径下搜索模块，从而确保模块能够被正确识别和包含。
方法 4：使用钩子（hook）文件
PyInstaller 支持使用钩子（hook）文件来定制打包过程。如果某些模块总是需要被包含，可以通过创建钩子文件来实现。
①创建钩子文件
在项目目录下创建一个 hooks 文件夹，并在其中创建一个钩子文件，例如 hook-your_module.py。内容如下：
from PyInstaller.utils.hooks import collect_submodules
hiddenimports = collect_submodules('your_module1') + collect_submodules('your_module2')②指定钩子文件路径
在打包时，通过 --additional-hooks-dir 参数指定钩子文件的路径：
pyinstaller --onefile \
--additional-hooks-dir=hooks \
your_script.py方法 5：动态导入模块
如果模块路径是动态的，或者无法通过静态方式指定，可以在代码中动态导入模块，并通过 sys.path 添加模块路径。例如：
import sys
sys.path.append('/path/to/module1')
sys.path.append('/path/to/module2')
import your_module1
import your_module2然后在打包时，使用 --hidden-import 指定这些模块：
pyinstaller --onefile \
--hidden-import=your_module1 \
--hidden-import=your_module2 \
your_script.py2. 修改.spec文件
PyInstaller在第一次运行时会生成一个.spec文件，其中包含了打包的详细配置信息。你可以通过修改这个.spec文件，手动添加需要包含的.pyd模块。（上方已有提到）
-
首先，使用PyInstaller生成
.spec文件，但不进行打包：pyinstaller --onefile your_script.py这会在当前目录下生成一个
your_script.spec文件。 -
打开
.spec文件，找到Analysis对象的hiddenimports列表，添加你的.pyd模块名：a = Analysis(['your_script.py'], ... hiddenimports=['your_module'], ...) -
保存并关闭
.spec文件，然后使用该.spec文件进行打包：pyinstaller your_script.spec
3. 将Python脚本或编译的*.pyd制作成自定义库并安装
自定义库结构示例：
yourLibrary/
│
├── yourLibrary/
│ ├── __init__.py
│ ├── module1.py
│ ├── module2.pyd # Windows上的扩展模块
│ ├── module3.so # Unix/Linux上的共享对象文件
│ ├── binaries/
│ │ ├── yourModule.dll # Windows上的DLL文件
│ │ └── otherfile.dat
│ └── data/
│ ├── somefile.txt
│ └── anotherfile.bin
│
├── setup.py
└── README.md① 编写setup.py
setup.py文件是Python包的分发脚本，用于描述您的包、如何构建它以及安装时应该包含哪些文件。
对于包含多种文件类型的自定义库，您需要在setup.py中指定这些文件。这通常通过package_data选项来实现，该选项允许您指定要包含在包中的非Python文件。
setup.py文件：
from setuptools import setup, find_packages
setup(
name='yourLibrary',
version='0.1',
packages=find_packages(),
package_data={
'yourLibrary': [
'module2.pyd', # Windows扩展模块
'module3.so', # Unix/Linux共享对象文件
'binaries/*.dll', # DLL文件
'data/*.txt', # 示例数据文件
'data/*.bin', # 示例二进制文件
],
},
include_package_data=True, # 确保package_data中的数据被包含
install_requires=[
# 在这里列出你的库依赖的其他Python包
],
description='A custom Python library with various file types',
long_description=open('README.md').read(),
long_description_content_type='text/markdown',
author='Your Name',
author_email='your.email@example.com',
url='https://github.com/yourusername/yourLibrary', # 替换为你的仓库URL
classifiers=[
'Programming Language :: Python :: 3',
'License :: OSI Approved :: MIT License',
'Operating System :: OS Independent',
],
python_requires='>=3.6',
)在这个示例中，package_data字典指定了yourLibrary包中应该包含的各种非Python文件。
② 构建和分发库
在命令行中，导航到包含setup.py文件的目录，然后运行以下命令来构建您的库：
python setup.py sdist bdist_wheel这将生成源代码分发包（.tar.gz）和wheel分发包（.whl）。
③ 安装库
接下来可以使用pip来安装你的库。如果已经构建了wheel包，可以直接安装它：
pip install dist/yourLibrary-0.1-py3-none-any.whl也可以从源代码分发包安装：
pip install dist/yourLibrary-0.1.tar.gz④ 测试库
安装完成后就可以创建一个新的Python脚本来测试这个库是否已经正确安装并且可以正常使用了。
4. 确保模块路径正确
如果.pyd文件位于非标准路径下，需要确保在打包时将该路径包含进去。可以使用--paths选项指定额外的模块搜索路径：（上方已有提到）
pyinstaller --onefile --paths=/path/to/your/pyd your_script.py这里/path/to/your/pyd是包含.pyd文件的目录路径。通过--paths选项，PyInstaller会在指定的路径下搜索模块，确保在打包时能够正确包含.pyd文件。
5. 使用__init__.py文件
如果.pyd文件是一个包的一部分，确保在包的根目录下有一个__init__.py文件。这个文件可以为空，但它的存在可以帮助PyInstaller正确识别包的结构。例如，假设你的包结构如下：
your_package/
│
├── __init__.py
├── your_module.pyd
└── other_module.py__init__.py文件可以为空，或者包含一些初始化代码。这样，PyInstaller在分析依赖关系时，能够更好地识别和包含包中的.pyd文件。
6. 检查.pyd文件的兼容性
确保.pyd文件与目标系统的Python版本和架构兼容。.pyd文件是针对特定的Python版本和架构编译的，如果目标系统上的Python环境与编译时的环境不一致，可能会导致运行时找不到模块或出现其他兼容性问题。例如，如果你在64位的Python环境下编译了.pyd文件，那么在32位的Python环境下运行时可能会出现问题。
7. 使用虚拟环境
在打包之前，建议在虚拟环境中进行操作。这样可以确保只有项目所需的依赖项被包含在打包文件中，避免全局环境中的其他包干扰。
-
创建虚拟环境
-
激活虚拟环境
-
在虚拟环境中安装项目依赖
pip install -r requirements.txt -
在虚拟环境中使用PyInstaller进行打包：
pyinstaller --onefile your_script.py
8. 查看PyInstaller的日志
在PyInstaller执行打包操作时，会生成详细的日志信息。如果尝试上述方法后，将*.py编译成*.pyd，并用pyinstaller将原本调用它的Python脚本打包为可执行文件运行仍然报错：“No module named…”，可通过查看这些日志，了解PyInstaller在分析依赖关系和打包过程中的详细情况，从而帮助定位问题。可以在命令行中添加--log-level=DEBUG选项，以获取更详细的日志信息：
pyinstaller --onefile --log-level=DEBUG your_script.py仔细检查日志文件，查找与.pyd模块相关的警告或错误信息，并根据提示进行相应的调整。
扫一扫
5266
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
