模块是包含Python代码的文件,包是包含多个模块的目录,通过__init__.py识别;使用import导入模块,from...import导入函数;包内可用相对或绝对导入,建议用绝对导入并合理命名,以提升项目结构清晰度与可维护性。

Python 中的包(Package)和模块(Module)是组织代码的基本方式,合理使用能让项目结构清晰、易于维护。理解它们的定义、用法及区别,对编写规范的 Python 程序至关重要。
什么是模块(Module)
模块是一个包含 Python 代码的文件,通常以 .py 结尾。它可以定义函数、类、变量,也可以包含可执行代码。导入模块后,就可以使用其中的内容。
例如,创建一个名为 math_utils.py 的文件:
# math_utils.py
def add(a, b):
return a + b
def multiply(a, b):
return a * b
在另一个脚本中导入并使用:
立即学习“Python免费学习笔记(深入)”;
import math_utilsprint(math_utils.add(2, 3)) # 输出 5 from math_utils import multiply print(multiply(2, 4)) # 输出 8
什么是包(Package)
包是包含多个模块的目录,用于组织相关功能的代码。要让 Python 将一个目录识别为包,必须在该目录下包含一个名为 __init__.py 的文件(可以为空,也可包含初始化代码)。
例如,项目结构如下:
myproject/
│
└── utils/
├── __init__.py
├── math_utils.py
└── string_utils.py
其中 utils 是一个包,可以通过以下方式导入:
from utils.math_utils import add from utils import string_utils
__init__.py 可用来定义包的公开接口,比如设置 __all__ 或提前导入常用模块:
# utils/__init__.py from .math_utils import add, multiply from .string_utils import to_upperall = ['add', 'multiply', 'to_upper']
相对导入与绝对导入
在包内部,模块之间可以相互导入。使用相对导入时,通过点(.)表示层级关系。
例如,在 string_utils.py 中想使用 math_utils.py 的函数:
# string_utils.py from .math_utils import adddef process(): return add(1, 2)
注意:相对导入只能在包内使用,不能直接运行包含相对导入的模块文件,否则会报错。
常见操作建议
- 模块命名应使用小写、简短、有意义的名称,避免与标准库或第三方库冲突
- 包目录中必须有 __init__.py 文件(Python 3.3+ 支持隐式命名空间包,但显式更安全)
- 使用 __all__ 控制 from package import * 导出的内容
- 推荐使用绝对导入,结构清晰,不易出错
- 大型项目可嵌套包,如 utils.db、utils.network
基本上就这些,掌握模块和包的使用,就能有效组织 Python 项目结构,提升代码复用性和可读性。











