Python / 系统课时
把代码拆到多个模块文件
把代码拆到多个模块文件
当 Python 程序从一个文件逐渐增长时,把功能拆分到多个模块可以降低维护成本。本篇将创建自己的模块文件,并通过 import 在不同文件之间复用函数,让代码结构更接近真实项目。
学习目标
- 理解 Python 模块的定义和文件对应关系
- 掌握创建模块并通过 import 调用代码的方法
- 能够设计简单的多文件 Python 项目结构
为什么需要拆分模块
Python 中一个 .py 文件就是一个模块。当项目包含数据处理、业务逻辑、工具函数等多个职责时,把所有代码放在同一个文件会导致查找困难、修改风险增加。
拆分模块后,每个文件可以负责相对独立的功能。例如,计算逻辑放在 calculator.py,程序入口放在 main.py。入口文件只负责组织调用,不需要知道每个功能的内部实现。
创建并使用自己的模块
假设有如下项目结构:
text
project/
├── main.py
└── calculator.py其中 calculator.py 负责提供计算函数:
python
# calculator.py
def add(a, b):
"""返回两个数字的和。"""
return a + b
def multiply(a, b):
return a * b在同目录下的 main.py 中导入模块:
python
# main.py
import calculator
result = calculator.add(3, 5)
print(result)运行 main.py 后,Python 会搜索当前目录中的 calculator.py,加载其中定义的函数,然后通过模块名访问函数。
预期输出
text
8理解模块加载过程
执行 import calculator 时,Python 会完成以下过程:
- 查找名为
calculator的模块。 - 执行模块文件中的代码。
- 创建模块对象并保存其中的变量、函数和类。
- 将模块对象绑定到当前文件的名称空间。
因此,模块中的顶层代码会在第一次导入时执行。实际项目中,通常避免在模块顶层直接执行复杂逻辑,而是把可执行流程放入函数或入口文件。
常见模块拆分方式
小型项目通常可以按职责拆分:
| 文件 | 职责 |
|---|---|
main.py |
程序入口,负责流程控制 |
utils.py |
通用工具函数 |
config.py |
配置常量 |
service.py |
业务处理逻辑 |
模块拆分不是简单增加文件数量,而是让每个模块拥有清晰边界。一个模块应该提供稳定的能力,而不是成为所有代码的临时存放位置。
模块导入失败时如何检查
如果出现 ModuleNotFoundError,优先检查以下问题:
- 模块文件名是否拼写正确。
- 当前运行目录是否包含模块文件。
- 文件名是否和第三方库名称冲突。
- 项目结构是否需要使用包导入。
例如,不要把自己的文件命名为 random.py、json.py 等标准库名称,否则可能覆盖 Python 原有模块。
合理拆分模块后,代码可以随着功能增长持续扩展,同时让团队成员更容易定位和修改代码。
按自己的节奏,确认真正理解。