Python 编程：从零基础到精通

第 14 课：模块、包与导入机制

所属模块：模块四：模块与包
难度：beginner
标签：modules, packages, import
上一课：Lambda 表达式与高阶函数
下一课：标准库之 os 与 sys 模块

1. 学习目标

完成本课学习后，你将能够：

理解 Python 模块和包的概念，明白为什么需要使用它们。
掌握使用 import 语句导入整个模块或模块中特定功能的各种方式。
学会创建包含多个模块的自定义包。
了解 __name__ 变量的特殊作用，并利用它控制模块中的代码执行。
规避模块导入时的一些常见陷阱。

2. 核心概念

想象一下，你的 Python 项目就像一个复杂的机械车间。如果把所有工具（代码）都堆在一个工作台上（一个巨大的 .py 文件），查找和使用起来会非常困难。

模块：就是一个 .py 文件。它将相关的函数、类和变量组织在一起。好比一个"工具箱"，里面装着锤子、螺丝刀等特定功能的工具。例如，math 模块就是一个装着数学计算工具的工具箱。
包：是一个包含 __init__.py 文件（这个文件可以是空的）的目录，里面可以放多个模块。它就像一个"工具架"，可以将多个相关的工具箱（模块）分门别类地存放。例如，你可以创建一个 my_utils 包，里面包含 math_tools.py 和 text_tools.py 两个模块。
导入：使用 import 关键字，就像是"从工具架上拿起你需要的工具箱（或其中的某个工具）"。导入后，你就可以在当前代码中使用这个模块或包里定义的功能了。

为什么需要模块和包？

代码复用：避免重复造轮子，一次编写，多处使用。
组织清晰：将庞大复杂的程序分解成多个小文件，逻辑更清晰。
命名空间：避免函数和变量名冲突。math.sqrt() 和 cmath.sqrt() 不会打架。

3. 代码示例

让我们通过一个实际项目来演示。首先，创建一个如下所示的目录结构：

my_project/
│
├── math_operations.py      # 这是一个模块
├── string_utils.py         # 这是另一个模块
│
└── my_package/             # 这是一个包
    ├── __init__.py         # 标识这是一个包（内容可为空）
    └── statistics.py       # 包内的一个模块

步骤1：创建模块文件

文件 math_operations.py

# 这是一个简单的数学运算模块
def add(a, b):
    """返回两个数的和"""
    return a + b

def multiply(a, b):
    """返回两个数的积"""
    return a * b

# 测试代码 - 注意 __name__ 的使用
if __name__ == "__main__":
    # 这段代码只在直接运行此模块时执行
    print(f"直接运行测试: 2 + 3 = {add(2, 3)}")
    print(f"直接运行测试: 2 * 3 = {multiply(2, 3)}")

文件 string_utils.py

# 这是一个字符串处理工具模块
def reverse_string(s):
    """返回字符串的反转形式"""
    return s[::-1]

def count_vowels(s):
    """计算字符串中元音字母的数量"""
    vowels = "aeiouAEIOU"
    return sum(1 for char in s if char in vowels)

步骤2：创建包 文件 my_package/__init__.py (可以留空，但为了演示，我们导入一些内容)

# 包的初始化文件
# 你可以在这里导入包中的子模块，让外部更容易访问
from .statistics import calculate_mean

文件 my_package/statistics.py

# 统计模块
def calculate_mean(numbers):
    """计算数字列表的平均值"""
    if not numbers:
        return 0
    return sum(numbers) / len(numbers)

def calculate_median(numbers):
    """计算数字列表的中位数"""
    sorted_nums = sorted(numbers)
    n = len(sorted_nums)
    mid = n // 2
    if n % 2 == 0:
        return (sorted_nums[mid - 1] + sorted_nums[mid]) / 2
    else:
        return sorted_nums[mid]

步骤3：使用导入机制 在 my_project/ 目录下创建一个主文件 main.py，演示各种导入方式。

文件 main.py

# 主程序文件，演示如何导入和使用模块/包

# 1. 导入整个模块
import math_operations
print("--- 导入整个模块 ---")
result1 = math_operations.add(10, 20)
print(f"使用模块名.函数名调用: 10 + 20 = {result1}")

# 2. 从模块中导入特定函数
from string_utils import reverse_string, count_vowels
print("\n--- 从模块中导入特定函数 ---")
text = "Hello, Python!"
rev = reverse_string(text)
vowels = count_vowels(text)
print(f"原字符串: '{text}'")
print(f"反转后: '{rev}'")
print(f"元音字母数量: {vowels}")

# 3. 给导入的模块或函数起别名（当名称太长或想避免命名冲突时）
import math_operations as mo  # 给模块起别名
from string_utils import count_vowels as cv  # 给函数起别名
print("\n--- 使用别名 ---")
print(f"使用别名调用: 5 * 6 = {mo.multiply(5, 6)}")
print(f"使用别名调用: 'Import Test' 的元音数 = {cv('Import Test')}")

# 4. 导入包中的模块
from my_package import statistics
print("\n--- 导入包中的模块 ---")
data = [2, 4, 6, 8, 10]
mean = statistics.calculate_mean(data)
median = statistics.calculate_median(data)
print(f"数据: {data}")
print(f"平均值: {mean}")
print(f"中位数: {median}")

# 5. 直接导入包中的函数（得益于 __init__.py 中的导入）
from my_package import calculate_mean  # 因为在 __init__.py 中导入过
print("\n--- 直接导入包中的函数 ---")
print(f"再次计算平均值: {calculate_mean(data)}")

# 6. 导入所有内容（不推荐，可能导致命名冲突）
# from math_operations import *  # 可以使用，但不推荐！

4. 实践练习

练习1：基础导入与使用

使用 Python 的 math 模块。
计算并打印圆的面积（给定半径 r=5）。
计算并打印一个 45 度角的正弦值。

预期输出示例：

半径为 5 的圆面积为: 78.53981633974483
45度角的正弦值约为: 0.7071067811865475

(注意：计算正弦值时需要先将角度转为弧度)

练习2：创建自定义模块与包

创建一个名为 geometry 的包。
在包内创建两个模块：shapes.py 和 calculations.py。
在 shapes.py 中定义一个函数 rectangle_area(length, width)。
在 calculations.py 中定义一个函数 circle_circumference(radius)。
在包的 __init__.py 中，让外部可以直接通过 from geometry import rectangle_area 的方式访问该函数。
编写主程序，从你的 geometry 包中导入并使用这两个函数，计算长为10、宽为5的矩形面积，以及半径为7的圆的周长。

练习3：__name__ 应用

修改练习2中 calculations.py 模块的代码。
为其中的 circle_circumference 函数编写测试代码。
使用 if __name__ == "__main__": 确保测试代码只在直接运行 calculations.py 时执行。
分别测试：直接运行 calculations.py 和从其他文件导入它，观察测试代码是否执行。

5. 常见错误

模块未找到错误 (ModuleNotFoundError)：
- 错误：import my_module 但文件不在同一目录或 Python 路径中。
- 解决：确保 .py 文件在正确位置，或将模块所在目录加入系统路径。
循环导入：
- 错误：模块A导入了模块B，同时模块B又导入了模块A，导致无限循环。
- 解决：重新组织代码，或将导入语句放在函数内部（延迟导入）。
混淆 import 和 from ... import：
- 错误：使用 from math_operations import * 后，又尝试用 math_operations.add() 调用，这会报错，因为 math_operations 命名空间并未被导入。
- 解决：统一使用风格。推荐使用 import module_name 或 from module_name import specific_item。
相对导入错误：
- 错误：在包内使用 from . import sibling_module 时，如果直接运行该脚本，会报错。
- 解决：相对导入只能在作为包的一部分被导入时使用。直接运行的脚本应使用绝对导入。
忽略 __init__.py 文件：
- 错误：在 Python 3.3+ 中，没有 __init__.py 的目录也可以作为"命名空间包"工作，但对于初学者和明确的包结构，建议始终包含它。

6. 小结

模块化是核心：将代码分解到不同的 .py 文件（模块）中，是编写可维护、可复用程序的关键。
导入是桥梁：使用 import、from ... import 等语句，可以在不同文件间共享代码功能。记住，import 的是模块或其中的名字，而不是执行文件。
包是组织结构：通过目录和 __init__.py 文件将相关模块组织成包，提供清晰的层级结构。
善用 __name__：if __name__ == "__main__": 是一个非常有用的惯用法，它让你的模块既能被导入复用，又能单独运行进行测试。
实践出真知：多动手创建自己的模块和包，理解导入机制，这是提升代码组织能力的重要一步。

现在，你已经掌握了 Python 模块化编程的基石。接下来，我们将探索 Python 自带的"标准库"中一些极其有用的模块！

练习编辑器

python