Python模块能否由多个文件构成？为何存在“通常对应单文件”的表述？

架构老林

2026-8-1

Python模块：单文件与多文件的真相

首先明确：Python模块完全可以由多个文件构成，教程里的“通常”是基于实际使用场景和入门教学的普遍情况。

为什么说“通常对应单个文件”？

入门教学的默认选择：Python入门阶段都会从单文件模块讲起，比如import my_module对应my_module.py，这种形式直观易懂，能快速让学习者掌握模块的基本使用逻辑。
简单功能的最优解：多数小型功能或工具类代码，用单个文件就能实现清晰的逻辑，没必要拆分，所以日常开发中单文件模块的占比很高。
官方文档的入门表述侧重：官方文档开头提到“模块是包含Python定义与语句的文件”，是针对最基础的单文件模块给出的定义，后续章节会补充包（多文件模块）的概念。

当功能复杂度提升，需要拆分代码时，我们会用**包（Package）**来实现多文件模块：

包本质是一个包含多个.py文件的目录，通常需要添加__init__.py文件（Python 3.3+允许无此文件，但保留它可以更灵活地控制模块导出逻辑）。
举个实际例子：
假设你有一个处理数据的模块，目录结构如下：
```
data_processor/
    __init__.py
    read_data.py
    clean_data.py
    analyze_data.py
```
这个data_processor就是一个多文件模块，你可以通过import data_processor导入整个模块，或者用from data_processor import clean_data导入其中的子模块。
包还可以嵌套，比如data_processor.utils，这是多文件模块的延伸形式，能更好地组织复杂的代码结构。