python包和模块的内容整理

模块是包含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

在另一个脚本中导入并使用：

import math_utils
print(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_upper
all = ['add', 'multiply', 'to_upper']

相对导入与绝对导入

在包内部，模块之间可以相互导入。使用相对导入时，通过点（.）表示层级关系。

例如，在 string_utils.py 中想使用 math_utils.py 的函数：

# string_utils.py
from .math_utils import add
def process():
return add(1, 2)

注意：相对导入只能在包内使用，不能直接运行包含相对导入的模块文件，否则会报错。

常见操作建议

• 模块命名应使用小写、简短、有意义的名称，避免与标准库或第三方库冲突
• 包目录中必须有 __init__.py 文件（Python 3.3+ 支持隐式命名空间包，但显式更安全）
• 使用 __all__ 控制 from package import * 导出的内容
• 推荐使用绝对导入，结构清晰，不易出错
• 大型项目可嵌套包，如 utils.db、utils.network

基本上就这些，掌握模块和包的使用，就能有效组织 Python 项目结构，提升代码复用性和可读性。