Python自定义模块打包与导入教程

本文档详细介绍了如何在Python中实现代码封装并打包成可导入的模块，以便于其他Python项目引用。主要步骤如下： 1. **文件结构设置**: - 创建一个名为`example`的文件夹，这是封装代码的基础结构。 - 在`example`文件夹中，放置需要打包的`.py`文件，如`run.py`，并确保添加一个名为`__init__.py`的特殊文件，这有助于Python识别这是一个包含模块的目录。 2. **`run.py`文件内容**: - 这是一个简单的示例，定义了一个名为`run`的函数，当作为主脚本运行时会打印消息。 - `if __name__ == '__main__':`语句用于检查模块是否被直接执行，而不是作为导入的模块，这样可以避免循环调用。 3. **`setup.py`文件编写**: - 在文件夹外部（与`example`同级）创建`setup.py`，这是用来配置模块打包的关键文件。 - 使用`setuptools`库，通过`find_packages()`函数自动发现并打包当前目录及其子目录下的所有`.py`文件。 - 设置`name`参数为模块的基本名称，例如`face_API`，`version`为版本号，`author`为开发者信息，`pymodules`指定需要打包的模块。 4. **安装步骤**: - 在Anaconda Prompt或命令行中，导航到包含`setup.py`的目录。 - 输入`python setup.py install`命令，这将安装模块到本地Python环境的site-packages目录中。 5. **编写自己的模块**: - 举例创建一个名为`module1.py`的文件，放在`my_package`目录下。 - 更新`setup.py`中的`pymodules`列表，如果有多文件，按照列表形式添加其他模块名。 6. **查看目录结构**: - 使用`tree`命令（或者Windows系统下`dir`命令）检查目录结构，确保文件和目录组织正确。 通过这些步骤，你不仅可以将自己编写的代码组织成模块，方便其他Python项目导入使用，还能学会如何通过`setup.py`文件进行安装和管理。这种模块化编程方法是Python软件开发的重要实践，有助于代码重用和项目维护。