### 创建自定义模块 在 Python 中，模块是组织代码的基本单元，可以包含变量、函数、类等，并且可以被其他 Python 程序引用和重用。开发者可以通过创建 `.py` 文件来定义一个模块，例如创建一个名为 `my_module.py` 的文件，并在其中定义函数、类和变量。 以下是一个简单的自定义模块示例： ```python # my_module.py def greet(name): print(f"Hello, {name}!") class MyClass: def __init__(self, value): self.value = value def print_value(self): print(self.value) # 一个全局变量 my_variable = 42 ``` 通过这种方式定义的模块可以在其他 Python 脚本中导入并使用，从而实现代码的复用和组织[^4]。 ### 使用自定义模块 要使用自定义模块，首先需要将模块文件放置在当前工作目录或 Python 解释器可以找到的路径中。然后，可以使用 `import` 语句导入模块并访问其内容： ```python # main.py import my_module # 调用模块中的函数 my_module.greet("Alice") # 创建模块中的类实例 obj = my_module.MyClass(100) obj.print_value() # 访问模块中的变量 print(my_module.my_variable) ``` 此外，也可以使用 `from ... import ...` 语法来导入模块中的特定部分： ```python from my_module import greet, MyClass greet("Bob") obj = MyClass(200) obj.print_value() ``` 通过这种方式，可以灵活地控制导入的内容，提高代码的可读性和可维护性[^4]。 ### 模块文档化和发布 为了提高模块的可读性，开发者可以在模块中添加文档字符串（docstring），描述模块的功能、使用方法和示例。例如： ```python # my_module.py """ 这是一个示例模块，包含一个函数、一个类和一个变量。 """ def greet(name): """ 打印问候语。 参数: name (str): 要问候的名字。 """ print(f"Hello, {name}!") class MyClass: """ 一个示例类，包含一个值和打印该值的方法。 属性: value (any): 存储的值。 """ def __init__(self, value): self.value = value def print_value(self): """ 打印存储的值。 """ print(self.value) # 一个全局变量 my_variable = 42 ``` 文档字符串不仅有助于其他开发者理解模块的功能，还可以通过工具自动生成文档。如果希望将模块发布为包，可以将其打包并通过 `pip` 安装。这通常涉及创建 `setup.py` 文件并使用 `setuptools` 工具进行打包和发布[^5]。 ### 综合示例 假设有一个项目结构如下： ``` project/ │ ├── my_module/ │ ├── __init__.py │ └── utils.py └── main.py ``` 其中，`my_module/utils.py` 包含一些实用函数，`my_module/__init__.py` 用于将目录标记为 Python 包。`main.py` 可以通过相对或绝对导入的方式使用模块： ```python # my_module/utils.py def add(a, b): return a + b # main.py from my_module.utils import add result = add(10, 20) print(result) # 输出 30 ``` 通过这种方式，可以将代码组织成模块和包，进一步提高项目的可读性和可维护性[^2]。 ###