Pyinstaller 打包时怎样导入自定义模块

在使用 Python 进行项目开发时，我们常常会将代码模块化，以便于管理和维护。当使用 Pyinstaller 对项目进行打包时，正确导入自定义模块成为一个关键问题。

要确保项目的目录结构清晰合理。假设我们有一个主程序 main.py，以及一个自定义模块 my_module.py。通常将它们放在同一目录下。例如，项目目录如下：

project/
│
├── main.py
└── my_module.py

在 main.py 中导入 my_module 很简单，直接使用 import my_module 语句即可。正常运行 main.py 时不会有问题，但使用 Pyinstaller 打包就可能出现找不到模块的错误。

在使用 Pyinstaller 时，最简单的情况是在命令行中直接指定要打包的主程序。例如：pyinstaller main.py。不过，这对于包含自定义模块的情况往往不够。为了让 Pyinstaller 正确识别自定义模块，我们可以使用 --add-data 选项。

如果项目目录结构不变，在命令行中可以这样操作：在 Windows 系统下，pyinstaller --add-data "my_module.py;." main.py；在 Linux 或 macOS 系统下，pyinstaller --add-data "my_module.py:." main.py。这里的 --add-data 选项用于将自定义模块添加到打包文件中。my_module.py 是要添加的模块路径，;（Windows）或 :（Linux/macOS）后面的 . 表示将模块添加到打包后的程序运行目录的当前目录下。

另外，还可以通过创建一个规范文件（.spec）来更精细地控制打包过程。在命令行中运行 pyinstaller --name my_project --onedir main.py 会生成一个 my_project.spec 文件。打开这个文件，在 datas 选项中添加自定义模块的路径信息。例如：

datas=[('my_module.py', '.')]

修改后保存，然后在命令行中运行 pyinstaller my_project.spec 即可完成打包。

通过上述方法，无论是简单项目还是复杂项目，都能让 Pyinstaller 在打包时正确导入自定义模块，顺利将项目打包成可执行文件，方便在不同环境中部署和使用。