Python中的内嵌注释以哈希字符开始。

hello = "Hello!" # This is an inline comment
print(hello)

你好!

注意，字符串文字中的哈希字符只是一个哈希字符。

dial = "Dial #100 to make an emergency call."
print(dial)

拨打100拨打紧急电话。

散列字符也可以用于单行或多行注释。

hello = "Hello"
world = "World"
# First print hello
# And print world
print(hello)
print(world)

你好 世界

用三双引号将文本括起来以支持docstring。

def say_hello(name):
    """
    This is docstring comment and
    it's support multi line.
    :param name it's your name
    :type name str
    """
    return "Hello " + name + '!'


print(say_hello("John"))

你好约翰!

在文本中加上三个单引号作为块注释。

'''
I don't care the parameters and
docstrings here.
'''

我认为它没有，除了一个多行字符串没有被处理。然而，大多数(如果不是所有的话)Python ide都有一个短键来“注释掉”多行代码。

Python确实有一个多行字符串/注释语法，在这种意义上，除非用作文档字符串，多行字符串不会生成字节码——就像#- prependedcomments一样。实际上，它的作用完全像注释。

另一方面，如果您说这种行为必须在官方文档中记录，才能成为真正的注释语法，那么是的，您说它不保证是语言规范的一部分是正确的。

在任何情况下，您的文本编辑器还应该能够轻松地注释掉所选区域(通过在每行前面单独放置#)。如果不是，切换到一个文本编辑器。

在没有特定文本编辑功能的情况下使用Python编程可能是一种痛苦的体验。找到正确的编辑器(并知道如何使用它)会对如何感知Python编程体验产生很大的影响。

文本编辑器不仅应该能够注释掉所选区域，还应该能够轻松地将代码块向左或向右移动，并且当您按下Enter时，它应该自动将光标置于当前缩进级别。代码折叠也很有用。

为了防止链接衰减，以下是Guido van Rossum的推文内容:

Python提示:你可以使用多行字符串作为多行注释。除非用作文档字符串，否则它们不会生成代码!: -)

你可以使用下面的方法。这叫做DockString。

def my_function(arg1):
    """
    Summary line.
    Extended description of function.
    Parameters:
    arg1 (int): Description of arg1
    Returns:
    int: Description of return value
    """
    return arg1

print my_function.__doc__

AFAIK, Python没有块注释。对于注释单个行，可以使用#字符。

如果你正在使用notepad++，有一个块注释的快捷方式。我相信其他的像gVim和Emacs也有类似的特性。

不幸的是，字符串化不能总是用于注释!因此，坚持在每行前加上#的标准更安全。

这里有一个例子:

test1 = [1, 2, 3, 4,]       # test1 contains 4 integers

test2 = [1, 2, '''3, 4,'''] # test2 contains 2 integers **and the string** '3, 4,'