python中的三种注释方法

当写Python代码时，我们需要在一些片段代码和特定表达式旁边添加一些注释。注释不会执行，而是为了方便代码的阅读和理解。Python提供了三种注释代码的方法。

单行注释

单行注释以井号(#)开始，直到行结束。单行注释通常在新行中独立写，也可以出现在代码行的后面。单行注释只针对一行代码进行注释。例如：

# 这是一行单行注释
print("Hello, World!")  # 这是输出语句

多行注释

多行注释也被称为块注释，是一个段落或代码行的一部分。我们使用三个单引号或双引号来注释一个或多个段落。例如：

"""
这是一段
多行注释
"""
print("Hello, World!")  # 这是输出语句

'''
这是另一段
多行注释
'''

文档字符串注释

文档字符串（Docstring）注释是位于函数、类、模块顶部的注释。它们应该被用来解释这些元素的功能和用途。它们支持多行注释，是在Python中编写文档的标准方式。例如：

def add(a, b):
    """
    用于两数相加的函数
    参数：a、b - 要相加的两个数
    返回值：两个数的和
    """
    return a + b

在这个函数中，文档字符串提供了这个函数的说明、参数以及返回值信息。它通常在函数的定义之后，而且应该以三个双引号或单引号开头和结尾。

以上是关于Python中三种不同注释方法的详细说明。在编写Python代码时，注释是一个非常重要的方面，可以提高代码的可读性和可维护性。