Python 注释:让你的代码更易读、更易懂

在编写代码时,添加注释可以提高代码的可读性和可维护性。注释就像代码中的说明书,帮助我们理解代码的功能、逻辑和意图。Python支持多种类型的注释,以下是一些常见示例:

1. 单行注释

# 这是一个单行注释

单行注释以 # 开头,注释内容位于 # 后面,仅对当前行有效。

2. 多行注释

'''
这是一个多行注释
可以写多行
'''

多行注释使用三个单引号 ''' 包裹,注释内容可以跨越多行。

3. 函数注释

def add(x: int, y: int) -> int:
    '''
    这是一个加法函数
    :param x: int, 加数1
    :param y: int, 加数2
    :return: int, 返回两数之和
    '''
    return x + y

函数注释使用三个单引号 ''' 包裹,注释内容可以包括函数的功能描述、参数说明和返回值说明。

4. 类注释

class Animal:
    '''
    这是一个动物类
    '''
    def __init__(self, name: str):
        '''
        构造函数
        :param name: str, 动物名字
        '''
        self.name = name

    def say_hello(self):
        '''
        动物打招呼
        '''
        print(f'{self.name} say hello!')

类注释使用三个单引号 ''' 包裹,注释内容可以包括类功能描述、属性说明和方法说明。

5. 模块注释

'''
这是一个模块注释
可以写模块的功能说明、版本号、作者等信息
'''
import math

def square_root(x: float) -> float:
    '''
    计算平方根
    :param x: float, 被开方数
    :return: float, 平方根
    '''
    return math.sqrt(x)

模块注释使用三个单引号 ''' 包裹,注释内容可以包括模块的功能说明、版本号、作者等信息。

总结

添加注释可以让代码更易读、更易懂,也方便维护。好的注释可以帮助我们快速理解代码的功能和逻辑,减少代码阅读和调试的时间。养成良好的注释习惯,让你的代码更加清晰易懂。

Python 注释详解:代码解释和文档生成

原文地址: https://www.cveoy.top/t/topic/mSXq 著作权归作者所有。请勿转载和采集!

免费AI点我,无需注册和登录