python - 内联 Python 文档的行长

Question

在编写内联文档时，是否有标准的换行方法来处理较长的文本行（显然这不应该经常发生）？

例如：

“这个模块做的废话废话废话废话废话废话废话废话废话”

或者应该是：

“这个模块可以做 blah blah blah blah blah blah blah blah blah blah blah
哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈
哈哈哈哈哈哈”

如果对此没有明确定义的标准或传统，我并不是真的在寻找辩论，在这种情况下，问题可能应该被关闭。但是，如果有标准或非常普遍的做法，我想知道它是什么。

Answer 1

对于像您问题中的示例这样的多行评论，您还可以使用 """三引号""" 让您的评论跨越换行符。

PEP 8风格指南建议

将所有行限制为最多 79 个字符

并且：

对于流动的长文本块（文档字符串或注释），建议将长度限制为 72 个字符。

样式指南中有一个关于 docstrings 的特定部分，这是一种特定类型的内联文档，您可以在此处找到。

Answer 2

在计算机世界中，行通常限制为 80 个字符，PEP 风格指南建议最多为 79 个。