Python中如何编写辅助模块module?

编写Python辅助模块需创建.py文件,如math_utils.py包含add、multiply函数和PI常量;在main.py中可import或from导入使用;建议文件名小写、加文档字符串、避免顶层复杂逻辑,便于复用维护。

编写Python辅助模块其实很简单,核心就是把常用的功能函数、类或变量整理到一个独立的.py文件中,供其他脚本导入使用。重点是结构清晰、命名规范、便于复用。

1. 创建基本模块文件

模块本质上就是一个Python脚本文件(.py)。比如你想写一个处理数学运算的辅助模块:

math_utils.py

def add(a, b):
    return a + b

def multiply(a, b):
    return a * b

PI = 3.14159

这个 math_utils.py 就是一个模块,里面包含两个函数和一个常量。

2. 在其他脚本中导入并使用

在同一目录下创建另一个文件 main.py 来使用这个模块:

main.py

import math_utils

result1 = math_utils.add(5, 3)
result2 = math_utils.multiply(4, 7)
print(result1) # 输出 8
print(result2) # 输出 28
print(math_utils.PI) # 输出 3.14159

也可以只导入需要的部分:

from math_utils import add, PI

print(add(2, 4)) # 直接调用

3. 模块组织建议

为了让模块更实用、易维护,注意以下几点:

  • 文件名使用小写字母和下划线,避免与标准库冲突
  • 加上文档字符串说明模块用途和函数用法
  • 避免在模块顶层写复杂逻辑,主要放可复用的函数或类
  • 可以按功能分类,多个模块组成包(加 __init__.py)

例如给函数加说明:

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

基本上就这些。写好一个模块后,只要路径正确, anywhere 都能 import 使用,特别适合封装重复代码。