谁能告诉我以下文档字符串参数之间的区别？
:type 和 :param
我已经看到两者都被用来指定方法参数的类型，但我认为它们的作用并不完全相同。其中一个用于程序员，另一个用于 IDE 或类似的东西？
:rtype、:return 和 :returns
尤其是 :return 和 :returns 看起来很像，那么分别在什么情况下使用呢？
【问题讨论】：
标签： python python-sphinx docstring pydoc
Sphinx 文档工具使用这些约定，该工具最初是为处理 Python 文档而设计的。然而，它的受欢迎程度使其扩展到其他领域，在 the Sphinx documentation 中定义为“用于描述和链接到属于一起的对象的标记集合（reStructuredText 指令和角色）”。
根据链接页面:return 来自 Python 域，:returns 来自 JavaScript 域，它们似乎都用于同一件事（ie 记录了函数或方法）。在实践中，:returns 很少出现，人们怀疑它是否是文档拼写错误。
:rtype 指定返回类型，并在可能的情况下创建指向类型定义的链接（即如果 Sphinx 可以在您正在记录的代码中找到定义）。
【讨论】：
它们本身没有任何意义。各种程序将扫描文档字符串并解释某些片段（或标签），专门用于格式化、链接等。按照惯例（以javadoc 开头？），这些标签通常以: 开头。除此之外，具体含义取决于解析文档字符串的程序，对于应该使用哪些标签没有明确的标准。有些程序使用:return 记录函数的返回值，有些程序使用:rtype。
您问题的唯一真正答案是，请查阅您希望处理文档字符串的程序的文档。
【讨论】：