[Python基础语法]注释

该教程介绍Python注释知识。注释可补充说明程序,不影响执行,能提升可读性与可维护性。Python支持三种注释方式,即单行注释(以井号开头)、多行注释(用井号分行)和文档注释(用'''定义,可用pydoc3命令生成文档)。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

这篇教程将向您展示关于Python注释的知识。

注释就是其字面意思,即对程序进行补充说明,但是不影响程序执行。注释使程序更具可读性和可维护性。

Python注释支持三种注释方式:

  1. 单行注释
  2. 多行注释
  3. 文档注释

单行注释


单行注释以井号(#)开头,并自动以EOL(行尾)结束。

>>> # 输出Hello, World!
... print("Hello, World!")
Hello, World!

注释与其下方的代码处于同一缩进级别

>>> def sum(a, b):
...     # 计算并返回a + b的值
...     return a + b
... 
>>> sum(2, 3)
5

多行注释


Python允许注释跨越多行。此类注释称为多行注释或块注释。

要添加多行注释,使用井号(#)后跟单个空格开始每一行。也可以将注释分成段落。只需在每个段之间添加一个带有井号(#)的空行。

>>> # 要学习任何语言,您必须遵守以下规则。
... # 1. 了解基本语法,数据类型,控制结构和条件语句。
... # 2. 学习错误处理和文件I/O。
... # 3. 了解高级数据结构。
... # 4. 编写函数并学习面向对象概念。
... 
>>> "Let's start to learn Python."
"Let's start to learn Python."

文档注释


文档注释是为每个Python模块,函数,类和方法添加快速注释。它必须是对象(模块,函数,类和方法)定义中的第一个语句。

使用’’'来定义文档注释

>>> def pow(a, n):
...     '''
... 计算并返回a的n次方。
...     '''
...     return a ** n
... 
>>> pow(2, 10)
1024
>>> print(pow.__doc__)

计算并返回a的n次方。
	

另外,我们也可以通过pydoc3命令生成注释文档。

$ ls -l /usr/local/bin/pydoc3 
lrwxr-xr-x  1 root  wheel  68 Sep 30 10:14 /usr/local/bin/pydoc3 -> ../../../Library/Frameworks/Python.framework/Versions/3.7/bin/pydoc3
------------
docstring.py文件
-------------
def pow(a, n):
    '''
计算并返回a的n次方
    '''
    return a ** n

-------------
$  pydoc3 ./docstring.py 
Help on module docstring:

NAME
    docstring

FUNCTIONS
    pow(a, n)
        计算并返回a的n次方

FILE
    /Users/xxx/Desktop/Python/docstring.py

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值