继之前讲过单元测试后，今天我们来学习文档测试。很多小伙伴问，文档测试又是什么？不着急，我们一起来学习。

看到Python的官方文档，很多都有示例代码，比如re模块就带了很多示例代码：

>>> import re
>>> m = re.search('(?<=abc)def', 'abcdef')
>>> m.group(0)
'def'

可以把示例代码在Python的交互式环境下输入执行，结果与文档的示例代码显示的一致。

当我们编写注释，写上下面的注释更友好：

def abs(n):
    '''
    Function to get absolute value of number.
 
    Example:
    >>> abs(1)
    1
    >>> abs(-1)
    1
    >>>abs(0)
    0
    '''
    return  n if n >= 0 else (-n)

好处：

•告诉函数的调用者该函数期望输入和输出

•Python内置的“文档测试”（doctest）模块可以直接提取注释中的代码并执行测试

•doctest 严格按照Python交互式命令行的输入和输出判断测试结果是否正确，只有测试异常的时候，可以用…表示一大推输出

以上就是使用python中文档测试的详解和优点，看完的小伙伴赶紧动手尝试吧。