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 原有模块。

合理拆分模块后,代码可以随着功能增长持续扩展,同时让团队成员更容易定位和修改代码。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把代码拆到多个模块文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通