函数文档字符串documentation string (docstring)是在函数开头,用来解释其接口的字符串.简而言之:帮助文档 包含函数的基础信息 包含函数的功能简介 包含每个形参的类型,使用等信息 是接口设计的重要部分. 注:一个良好的接口不能简单.清晰的表述该函数,则说明该函数还有优化改进的空间 函数文档的使用 必须在函数的首行,经过验证前面有注释性说明是可以的,不过最好函数文档出现在首行 使用三引号注解的多行字符串(当然,也可以是一行),因三引号可以实现多行注解(展示)(''' '…