Skip to content

注释:代码的贴心小助手

在编写 Python 代码时,注释就像是给代码添加的便签,用来解释代码的功能、目的或实现方法。好的注释能大大提高代码的可读性,方便自己和他人理解。Python 支持两种类型的注释:单行注释和多行注释。

单行注释:简洁明了的说明

单行注释以井号 # 开头。在 # 符号之后,直到行尾的所有内容都会被 Python 解释器忽略。这意味着你可以用它来添加简短的解释或备注,而不会影响代码的执行。

python
# 这是一个单行注释,用于解释下一行代码的作用
a = 1  # 将整数 1 赋值给变量 a

多行注释:详细的说明文档

多行注释允许你添加跨越多行的注释,非常适合用于详细的解释、函数或类的文档字符串(docstring)等。多行注释使用三个单引号 ''' 或三个双引号 """ 将注释内容包裹起来。

python
"""
这是一个多行注释。
它可以跨越多行,用于提供更详细的说明。
例如,可以用来描述一个函数的功能、参数和返回值。
"""

'''
这也是一个多行注释,与上面的双引号形式效果相同。
选择哪种形式取决于个人偏好或项目规范。
'''

最佳实践:注释的缩进

为了保持代码的整洁和可读性,多行注释通常应该与它所注释的代码块保持相同的缩进级别。这有助于区分注释和代码,并使代码结构更加清晰。

例如:

python
"""
程序从这里开始执行
"""
if x < 10:
    """
    当 x 小于 10 时,执行以下代码块
    """
    print("x 小于 10")
    if x <= 5:
        """
        当 x 小于或等于 5 时,执行以下代码块
        """
        print("x 小于或等于 5")
    else:
        """
        当 x 大于 5 但小于 10 时,执行以下代码块
        """
        print("x 大于 5 但小于 10")
else:
    """
    当 x 不小于 10 时,执行以下代码块
    """
    print("x 不小于 10")