### 如何在 Python 项目中正确导入和使用自定义包 在 Python 中，调用自定义包需要遵循一定的规则和结构。以下是关于如何创建、导入和使用自定义包的详细说明。 #### 包的结构 一个自定义包通常是一个包含多个模块的目录。为了使 Python 将该目录识别为包，必须在目录中包含一个名为 `__init__.py` 的文件[^2]。此文件可以为空，但它的存在告诉 Python 解释器该目录应该被视为一个包。 例如，假设有一个名为 `my_package` 的包，其结构如下： ```plaintext my_package/ __init__.py my_module1.py my_module2.py ``` #### 创建自定义包 创建自定义包的过程包括以下步骤： - 创建一个目录，并为其命名（如 `my_package`）。 - 在该目录下添加一个 `__init__.py` 文件[^2]。 - 根据需要添加其他模块文件（如 `my_module1.py` 和 `my_module2.py`）。 #### 导入自定义包 要从项目中导入自定义包，首先需要确保 Python 能够找到该包。这可以通过将包所在的目录添加到 `sys.path` 中实现[^4]。例如： ```python import sys import os # 假设 my_package 位于当前工作目录下的 packages 目录中 sys.path.append(os.path.abspath("packages")) import my_package.my_module1 from my_package import my_module2 ``` 如果包位于项目的顶级目录中，则可以直接导入，而无需修改 `sys.path`。例如： ```python import my_package.my_module1 from my_package import my_module2 ``` #### 使用相对导入 在同一个包内，可以使用相对导入来引用其他模块。例如，在 `my_module1.py` 中，可以这样导入 `my_module2`： ```python from . import my_module2 ``` 或者： ```python from .my_module2 import some_function ``` #### 运行包作为脚本 如果希望将包作为一个脚本运行，可以在包中添加一个 `__main__.py` 文件[^4]。然后，可以通过以下命令运行整个包： ```bash python -m my_package ``` #### 示例代码 以下是一个完整的示例，展示如何创建和使用自定义包： ```python # my_package/__init__.py # 此文件可以为空 # my_package/my_module1.py def function_from_module1(): print("This is a function from my_module1") # my_package/my_module2.py def function_from_module2(): print("This is a function from my_module2") ``` 在主程序中使用该包： ```python import sys import os sys.path.append(os.path.abspath("path/to/packages")) import my_package.my_module1 from my_package import my_module2 my_package.my_module1.function_from_module1() my_module2.function_from_module2() ```