好的，下面详细介绍如何创建一个包含两个 `.py` 文件的 Python 包。我们将一步步完成这一过程，并确保每一步都清晰明了。 ### 步骤 1: 初始化项目目录结构 首先，在你喜欢的地方新建一个文件夹作为你项目的根目录。假设我们把这个新包叫做 `mypackage`: ```bash mkdir mypackage cd mypackage ``` 然后在这个根目录下再创建一个新的子文件夹也叫 `mypackage`(注意大小写敏感)，这将是我们的包名所在的目录： ```bash mkdir mypackage ``` 现在你的项目结构看起来应该是这样的： ``` /mypackage # 根目录 └── /mypackage # 包目录 ``` ### 步骤 2: 添加必要的文件 #### (a) 创建初始化文件 (`__init__.py`) 为了让 Python 把该文件夹识别成一个“包”，我们需要在里面放置一个名为 `__init__.py` 的空文本文件。它既可以是完全空白的内容，也可以加入一些导入语句来简化用户使用体验。 进入刚刚创建的那个内部同名文件夹并添加此文件： ```bash touch mypackage/__init__.py ``` 如果需要的话可以在编辑器里打开 `__init__.py`, 并写下类似以下内容方便别人直接引用整个包里的功能而不需要逐个import每个模块(这里以假定存在两个.py为例): ```python from .module_a import function_from_module_a from .module_b import class_from_module_b # 这样使用者只需要 from mypackage import * 就可以访问所有公开APIs. ``` #### (b) 编辑具体的功能模块(`module_a.py`, `module_b.py`) 接下来就是编写我们要提供的实际业务逻辑啦！分别在这两个文件中实现各自负责的任务。比如说我们可以简单地这样做： **module_a.py** ```python def function_from_module_a(): print("This is a simple function in module A.") ``` **module_b.py** ```python class ClassFromModuleB: def __init__(self): self.message = "Hello world!" def say_hello(self): return f"Message from Module B's class: {self.message}" ``` 此时，完整的项目结构应当如下所示： ``` /mypackage # Root directory for your project ├── setup.py # Optional but recommended file to facilitate installation and distribution later on └── mypackage # Package content goes here; contains the following items... ├── __init__.py ├── module_a.py └── module_b.py ``` > **提示:** 如果计划将此包发布出去供他人安装，则还需要额外准备诸如 `setup.py` 配置脚本等其他辅助文档。不过目前仅用于本地测试是可以省略这部分工作的。 ### 步骤 3: 测试新的自定义库 为了验证一切正常工作，请尝试在一个交互式解释器会话或者单独的新Python脚本种引入刚才制作的小型库试试看吧！ 例如启动Python Shell之后输入如下命令来进行简单的检验： ```python >>> import sys >>> sys.path.append('/path/to/your/project/root') # 替换为实际路径 >>> from mypackage.module_a import function_from_module_a >>> function_from_module_a() 'This is a simple function in module A.' >>> from mypackage.module_b import ClassFromModuleB >>> cb = ClassFromModuleB() >>> cb.say_hello() 'Message from Module B\'s class: Hello world!' ``` 如果你能按照上述步骤顺利完成并且成功运行以上示例代码，恭喜！你就已经学会了如何创建属于自己的第一个小型Python软件包～