Python基础教程（四十五）文档测试：Python文档测试：藏在注释里的自动化魔法

藏在注释里的守护者：Python 文档测试深度解析

想象一下：你精心编写的函数文档示例，不仅能指导用户，还能自动验证代码的正确性！Python 的 doctest 模块正是实现这一魔法的秘密武器。它超越了传统注释，将文档字符串(docstring)变成了一个轻量级但强大的自动化测试平台。

一、 核心机制：文档即测试

doctest 的核心思想简洁而巧妙：

1. 模式识别： 在模块、类、函数的 docstring 中，寻找以 >>> 开头的行（模拟 Python 交互式提示符）。
2. 命令执行： 解析并执行 >>> 后的 Python 语句。
3. 输出验证： 检查紧随其后的行是否与代码执行后的实际输出完全一致。
4. 报告结果： 任何不匹配都会被标记为测试失败。

def factorial(n):
    """
    计算阶乘。
    >>> factorial(5)
    120
    >>> factorial(0)
    1
    >>> factorial(1)
    1
    """
    if n == 0:
        return 1
    return n * factorial(n-1)