在Python中，注释是用于解释和说明代码的作用的文本。注释不会被解释器执行，它们只是用于程序员之间的交流和理解代码。注释对于代码的可读性和可维护性非常重要。

3.4.1 单行注释

单行注释以#符号开头，后面跟随注释内容。单行注释用于在代码中添加简短的注释说明。

# 这是一个单行注释

在上述示例中，#后的内容被视为注释，不会被解释器执行。

3.4.2 多行注释

多行注释用于添加较长的注释内容，它以'''或"""开始和结束。多行注释通常用于对函数、类或模块进行详细的注释说明。

'''这是一个多行注释'''

在上述示例中，'''之间的内容被视为注释，不会被解释器执行。

3.4.3 文档字符串（Docstrings）

文档字符串是在函数、类或模块的定义处添加的字符串，用于提供对该函数、类或模块的详细说明文档。文档字符串通常包含函数或方法的目的、参数说明、返回值说明以及示例代码等。

def my_function(param1, param2):  """  这是函数的文档字符串。  :param param1: 参数1的说明  :param param2: 参数2的说明  :return: 返回值的说明  """  # 函数的实现print(my_function.__doc__) # 打印函数的文档字符串

在上述示例中，我们使用三重引号"""来定义函数的文档字符串，其中使用了特定的格式来描述函数的参数和返回值。

文档字符串可以通过__doc__属性来访问，并可以通过工具生成文档或使用help()函数来查看。

编写清晰和详细的注释和文档字符串是良好编程习惯的一部分。它们不仅可以帮助他人理解和使用你的代码，还可以提高代码的可读性和可维护性。在编写Python代码时，务必养成良好的注释和文档字符串习惯。