2

我知道在 python 中留下评论的两种方法。一个正在使用""",另一个正在使用#。我知道第一个可以用来返回函数帮助作为好处。但是我应该什么时候使用一个,什么时候使用另一个呢?还有我该如何发表评论?我是否必须按 Tab 并使用其下方的命令排列第一行评论?还是我必须从行首开始?

4

1 回答 1

8

不,只有一种评论方式,使用#

注释以不属于字符串文字的哈希字符 (#) 开头,并在物理行的末尾结束。

三引号, """, 创建一个字符串对象,当它是函数、模块或类的第一行时,它恰好被用作文档字符串。三重引用在许多其他地方也很有用,但不应与注释混淆。您可以像使用任何其他字符串文字一样使用三引号字符串,其具体好处是您可以在源代码中使用实际的换行符,而不必使用\n转义字符。

尽管它可以通过将代码块转换为多行字符串来禁用它,但您确实不应该这样做。使用适当的源代码控制并简单地删除块,或者使用一个编辑器,让您通过为您插入来注释掉整个块#

对于实际评论,请使用#. Python 风格指南(PEP 8)有一些关于何时以及如何使用注释的内容;关于缩进有这样的说法:

块注释通常适用于跟随它们的部分(或全部)代码,并且缩进到与该代码相同的级别。块注释的每一行都以 # 和一个空格开头(除非它是注释内的缩进文本)。

于 2013-06-23T15:32:31.510 回答