Python 教程 / 模块拆分、import 与查找路径

模块是可复用 Python 代码的组织单位,最常见的起点是一个 .py 文件。import会查找并初始化模块,再绑定名称;它不是简单地复制文件文字,因此文件位置、命名与顶层执行语句都会影响结果。

把计算与调用程序分开

将重复使用的计算函数放入 expense_math.py,将调用和显示结果的代码放入 app.py。两份文件先保存在同一个独立练习目录,不需要安装第三方包。这样可以复用计算逻辑,同时让显示方式与计算规则分别维护。

import expense_math绑定模块名称,通过 expense_math.total 访问函数;from expense_math import total直接绑定 total 名称。后一种写法不会同时创建 expense_math 名称,而且要注意是否覆盖已有同名函数。避免随意使用星号导入,令名称来源难以追踪。

模块文件名使用下划线,不使用连字符。不要把练习文件命名为 json.py 或 csv.py,否则可能遮蔽同名标准库模块。具体机制见Python 官方模块教程;函数输入输出的基础可参考函数定义与返回值。

创建两份完整文件并运行

先以 UTF-8 保存 expense_math.py,完整内容如下:

def total(amounts):
    return sum(amounts)

在相同目录保存 app.py,完整内容如下:

import expense_math

print(expense_math.total([3500, 8000, 2500]))

在这两份文件所在目录打开终端,选择项目的 Python 环境,执行:

python app.py

预期输出一行 14000,即 3500、8000、2500 的和。若系统配置使用 python3,就使用已核对过的解释器运行 python3 app.py。不要为了本例另外安装名为 expense_math 的外部包;这个名称对应的是你刚保存的本地文件。

检查查找路径与首次初始化

模块查找受到运行方式、项目结构与当前解释器环境影响。按本例执行文件时,脚本所在目录参与查找;在其他目录使用交互解释器或不同入口导入时,查找条件可能不同。看到 ModuleNotFoundError,先核对文件名、大小写、保存位置、实际解释器和运行命令,不要先修改 sys.path 或把文件复制进全局安装目录。

以下布局只是 main.py 导入 helper.py 的另一个命名示意,不是要求你把本例文件改名:

practice/
  main.py
  helper.py

本次实习继续使用 app.py 与 expense_math.py。在终端执行 python -c "import sys; print(sys.executable)"可以查看正在使用的解释器。检查自己加载的文件时,可执行 python -c "import expense_math; print(expense_math.__file__)"。该检查仍会导入模块,因此应先确认是自己可信的练习文件。

模块顶层语句通常在当前进程第一次导入该模块时运行;再次普通导入通常会使用 sys.modules 中的缓存,不会重复执行同一初始化。编辑文件后,初学阶段可以结束旧进程再重新运行验证。更详细的查找与缓存规则见Python 官方 import 系统说明。

把 input、文件删除或网络请求直接放在顶层,可能令其他程序只想导入函数时也启动操作。可复用工作应定义在函数中,实际程序通过明确入口调用。例如将运行代码放进 main 函数,再在 if __name__ == "__main__":条件下调用 main,可区分直接运行与作为模块导入。定义函数本身不会自动调用函数体。

观察初始化并避免循环依赖

  1. 只将 app.py 中的 8000 改成 9000,重新运行后应输出 15000,再恢复 8000 确认回到 14000。这验证调用方可以复用同一个计算函数。
  2. 在 expense_math.py 顶层临时增加 print("module loaded"),重新运行 app.py,应先看到 module loaded,再看到 14000。在同一进程连续导入两次,通常只出现一次该提示。观察后删除临时打印并再次核对原始结果。
  3. 检查练习目录有无 json.py、csv.py 等可能冲突的文件。如果自己误建了这些练习文件,应先确认内容,再改为明确的项目名称,重启旧解释器后重新验证,不要修改标准库文件。

两个模块互相导入,并且在初始化完成前就要求对方提供名称时,可能出现循环 import 错误。先整理依赖方向:例如把共同的纯计算提取到第三个模块,让调用程序与其他模块都依赖它。仅把 import 随意移动位置可能暂时避开症状,却未必解决相互依赖的设计问题。