一、介绍
Python是一种高级编程语言，它以简洁的语法和强大的功能而著称。其中一个非常有用的功能是多行注释，它允许程序员在代码中添加注释，以便其他人更容易阅读和理解代码。本文将以 Python 的多行注释为中心，介绍其基本语法和用法。
二、基本语法
Python 的多行注释使用三个单引号或三个双引号将注释括起来，如下所示：
''' 这是一个多行注释的示例。 它可以用来对代码做出解释。 '''
如果你愿意，你还可以将多行注释添加到函数、类、模块和包的开头，以便为这些实体添加文档字符串：
def my_function():
"""
这是一个多行注释的示例。
它是一个文档字符串，用于为 my_function() 函数添加描述。
"""
#这是一个单行注释，用于描述 my_function() 函数的具体行为。
三、用法
1、给代码添加注释
多行注释的主要目的是在代码中添加注释，以便其他人更容易理解你的代码。通过添加注释，你可以解释代码的工作原理、解释代码的目的以及解释代码所做的事情，从而帮助别人更好地理解代码。
例如，以下代码段使用多行注释来描述一个函数：
def my_function(x,y):
'''
这个函数接收两个参数，x 和 y，然后将它们相加并返回结果。
'''
return x+y
2、添加文档字符串
文档字符串是指在函数、类、模块和包的开头添加的多行注释。它们通常用于描述实体的作用、参数、返回值和使用示例。这些注释可以自动提取为文档，并帮助其他人在您的代码中找到所需的信息。
以下是一个使用文档字符串的示例：
def my_function(x,y):
"""
将两个数字相加并返回结果。
参数：
x -- 第一个数字
y -- 第二个数字
返回值：
两个数字的和
"""
return x+y
3、在代码中禁用/启用单行语句
有时候您需要在调试代码时禁用一行或多行代码，或者需要在调试之后重新启用它们。在 Python 中，您可以使用单行注释来禁用代码，或者使用多行注释来禁用更多的代码行。一旦您完成了调试，您可以删除这些注释或重新启用它们。
以下是一个使用单行注释禁用代码行的示例：
# 计算两个数的和（此行被禁用） # result = num1 + num2（此行被禁用） result = num1 - num2 # 计算两数之差（此行被启用）
四、结论
Python 中的多行注释是一种非常有用的功能。它们可以用于添加注释、生成文档字符串、禁用代码行等等。尽管它们有时被忽视，但多行注释无疑是 Python 一个非常强大的功能。现在，您已经掌握了多行注释的基础知识和用法，希望您能够在您的 Python 项目中充分利用它们。