Python文档测试怎么操作？

对于一个文章开发者来说，牢固扎实的基础是十分重要的，golang学习网就来带大家一点点的掌握基础知识点。今天本篇文章带大家了解《Python文档测试怎么用？》，主要介绍了，希望对大家的知识积累有所帮助，快点收藏起来吧，否则需要时就找不到了！

Python文档测试主要使用doctest模块，它从docstring提取交互式示例自动验证代码；支持内联测试、外部文件测试及特殊指令处理异常和省略输出。

Python 中做文档测试主要使用 doctest 模块，它能从函数的文档字符串（docstring）中提取交互式 Python 示例，并自动运行这些示例来验证代码是否按预期工作。这种方式让测试和文档保持同步，既写说明又做测试。

1. 编写带测试用例的文档字符串

在函数或模块的 docstring 中，按照 Python 交互式解释器的格式写测试样例：

def add(a, b):
    """
    返回两个数的和。
<pre class="brush:python;toolbar:false;">示例：
&gt;&gt;&gt; add(2, 3)
5
&gt;&gt;&gt; add(-1, 1)
0
&gt;&gt;&gt; add(0, 0)
0
"""
return a + b

注意：>>> 表示输入，其后紧跟的是期望输出。doctest 会执行这些输入并检查输出是否一致。

2. 运行 doctest

可以在代码末尾添加以下内容，运行时自动检测所有 docstring 中的测试：

if __name__ == "__main__":
    import doctest
    doctest.testmod()

保存为文件如 math_tool.py，在终端运行：

python math_tool.py

如果所有测试通过，不会有任何输出。加上 -v 参数可查看详细结果：

python math_tool.py -v

3. 在独立文档文件中写测试

你也可以把测试写在纯文本文件中，比如 example.txt：

The add function
>>> from math_tool import add
>>> add(3, 4)
7

然后用 doctest 运行这个文件：

import doctest
doctest.testfile("example.txt")

4. 处理特殊情况

有些输出可能包含空格、异常或省略部分内容，可以使用特殊指令控制匹配行为：

• 忽略多余空白：使用 # doctest: +ELLIPSIS

  >>> print(list(range(10)))  # doctest: +ELLIPSIS
  [0, 1, ..., 9]
  

• 测试异常：直接写出 traceback

  >>> add("hello", 5)
  Traceback (most recent call last):
    File "<stdin>", line 1, in <module>
    File ".../math_tool.py", line 10, in add
      return a + b
  TypeError: can only concatenate str (not "int") to str
  

基本上就这些。doctest 简单直接，适合教学、小项目或确保文档示例始终有效。对于复杂测试，建议搭配 unittest 或 pytest 使用。但日常写工具函数时，用 doctest 写例子顺便完成测试，很高效。

文中关于Python,文档测试的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Python文档测试怎么操作？》文章吧，也可关注golang学习网公众号了解相关技术文章。