我知道在 python 中留下评论的两种方法。一个正在使用"""
,另一个正在使用#
。我知道第一个可以用来返回函数帮助作为好处。但是我应该什么时候使用一个,什么时候使用另一个呢?还有我该如何发表评论?我是否必须按 Tab 并使用其下方的命令排列第一行评论?还是我必须从行首开始?
问问题
170 次
1 回答
8
不,只有一种评论方式,使用#
:
注释以不属于字符串文字的哈希字符 (#) 开头,并在物理行的末尾结束。
三引号, """
, 创建一个字符串对象,当它是函数、模块或类的第一行时,它恰好被用作文档字符串。三重引用在许多其他地方也很有用,但不应与注释混淆。您可以像使用任何其他字符串文字一样使用三引号字符串,其具体好处是您可以在源代码中使用实际的换行符,而不必使用\n
转义字符。
尽管它可以通过将代码块转换为多行字符串来禁用它,但您确实不应该这样做。使用适当的源代码控制并简单地删除块,或者使用一个编辑器,让您通过为您插入来注释掉整个块#
。
对于实际评论,请使用#
. Python 风格指南(PEP 8)有一些关于何时以及如何使用注释的内容;关于缩进有这样的说法:
块注释通常适用于跟随它们的部分(或全部)代码,并且缩进到与该代码相同的级别。块注释的每一行都以 # 和一个空格开头(除非它是注释内的缩进文本)。
于 2013-06-23T15:32:31.510 回答