使用模块的主要优点：

• 代码复用 - 避免重复编写相同代码
• 命名空间 - 避免命名冲突
• 组织代码 - 将大型程序分解为逻辑单元
• 可维护性 - 更易于理解和维护代码

# 文件名: math_utils.py
"""一个简单的数学工具模块"""

def add(a, b):
    """返回两个数字的和"""
    return a + b

def subtract(a, b):
    """返回两个数字的差"""
    return a - b

def multiply(a, b):
    """返回两个数字的乘积"""
    return a * b

def divide(a, b):
    """返回两个数字的商"""
    if b == 0:
        raise ValueError("除数不能为零")
    return a / b

PI = 3.14159  # 模块级常量
                

# main.py - 使用math_utils模块

# 导入整个模块
import math_utils

print("使用math_utils模块:")
print(f"5 + 3 = {math_utils.add(5, 3)}")
print(f"5 * 3 = {math_utils.multiply(5, 3)}")
print(f"圆周率近似值: {math_utils.PI}")

# 导入特定函数
from math_utils import subtract, divide

print("\n使用导入的特定函数:")
print(f"10 - 4 = {subtract(10, 4)}")
print(f"20 / 5 = {divide(20, 5)}")

# 使用别名
import math_utils as mu

print("\n使用模块别名:")
print(f"7 * 8 = {mu.multiply(7, 8)}")
                

my_package/
├── __init__.py       # 标识这是一个Python包
├── math_utils.py     # 数学工具模块
├── string_utils.py   # 字符串工具模块
└── file_utils.py     # 文件操作工具模块
                

使用：math_utils.add(2, 3)

使用：multiply(4, 5)

def add(a, b):
    """
    返回两个数字的和
    
    参数:
        a (int/float): 第一个数字
        b (int/float): 第二个数字
        
    返回:
        int/float: 两个数字的和
        
    示例:
        >>> add(2, 3)
        5
        >>> add(2.5, 3.1)
        5.6
    """
    return a + b
                

"""
math_utils.py - 数学工具模块

该模块提供基础的数学运算函数，包括：
- 加法
- 减法
- 乘法
- 除法

作者: YourName
创建日期: 2023-10-15
版本: 1.0
"""
                

if __name__ == '__main__':
    # 模块测试代码
    print("运行模块测试...")
    assert add(2, 3) == 5, "加法测试失败"
    assert subtract(5, 2) == 3, "减法测试失败"
    assert multiply(3, 4) == 12, "乘法测试失败"
    assert divide(10, 2) == 5, "除法测试失败"
    print("所有测试通过!")
                

模块结构建议

# 1. 模块文档字符串
"""模块的简要描述"""

# 2. 导入依赖
import os
import sys

# 3. 模块级常量
MAX_SIZE = 100

# 4. 函数和类定义
def function1():
    ...

class MyClass:
    ...

# 5. 主程序（测试代码）
if __name__ == '__main__':
    # 测试代码
    ...