Python 注释（Python Comments）用法详解

@

目录

  • 1 Python 注释概述
  • 2 Python 注释的作用
    • 2.1 调试代码
    • 2.2 提高程序的可读性
  • 3 Python 单行注释
    • 3.1 Python 单行注释概述
    • 3.2 单行注释注释单行代码的情况
    • 3.3 单行注释注释多行代码的情况
    • 3.4 单行注释注意事项
      • 3.4.1 单行注释符号作为字符串的一部分存在
  • 4 Python 多行注释
    • 4.1 Python 多行注释概述
    • 4.2 三个连续的单引号注释
    • 4.3 三个连续的双引号注释
    • 4.4 多行注释也可以为函数提供说明文档
    • 4.5 多行注释注意事项
      • 4.5.1 多行注释不支持嵌套
      • 4.5.2 多行注释符号‘‘‘或"""作为字符串标记
  • 5 文章其它地址
    • 5.1 微信公众号：码农阿杰
    • 5.2 CSDN博客
  • 6 参考资料
    • 6.1 Python 3.8.2 documentation

1 Python 注释概述

注释（Comments）是用来向开发者（用户）提示或解释某些代码的思路、作用和功能等，可以添加到代码中的任何位置。Python 解释器（Python Interpreter）在执行程序（代码）时会忽略注释部分，不做任何处理，即注释部分不会被 Python 解释器执行。

在代码中添加适当的注释量很重要，注释通常占源代码的 1/3 左右。

Python 支持两种类型的注释：单行注释和多行注释。

2 Python 注释的作用

2.1 调试代码

在调试（Debug）程序的过程中，单行注释可以用来临时快速注释某些代码，达到缩小错误范围、提高调试程序效率的目的。

具体操作如下：

在不确定具体是哪一行代码出错的情况下，我们可以先把觉得可能有问题的代码注释起来，然后再运行程序观察结果。如果程序可以正常执行，则可以说明错误就是由这段代码引起的；反之，如果依然出现相同的错误，则可以说明错误不是由这段代码引起的。

2.2 提高程序的可读性

注释的最大作用是提高程序的可读性，没有注释的程序是很难让人看懂的，说是天书也不为过。

更甚至，自己写的代码，过了一段时间以后，自己也会忘记思路或者目的。

3 Python 单行注释

3.1 Python 单行注释概述

Python 中是使用井号#作为单行注释的符号，其语法格式如下所示：

# 添加的注释内容

对以上语法格式的说明：

  • #作为单行注释的符号。
  • 从井号#开始，直到这行结束为止的所有内容都是注释。Python 解释器遇到#时，会忽略它后面的整行内容，即#之后的一行内容都属于注释部分。

3.2 单行注释注释单行代码的情况

单行注释注释单行代码时通常会将注释放在代码的右侧，与代码之间用两个空格隔开，如下所示：

print("码农阿杰")  # 输出笔者的微信公众号名称
print(‘https://www.cnblogs.com/manongajie/‘)  # 输出笔者的博客园博客地址
print(‘https://blog.csdn.net/manongajie/‘)  # 输出笔者的CSDN博客地址

3.3 单行注释注释多行代码的情况

单行注释注释多行代码时通常将注释放在代码的上一行，如下所示：

# 使用 print() 内置函数输出字符串
print("微信公众号：码农阿杰")
print("博客园博客地址 https://www.cnblogs.com/manongajie/")
print("CSDN 博客地址 https://blog.csdn.net/manongajie/")

# 使用 print() 内置函数输出数字
print(520)
print(521)
print(1314)

3.4 单行注释注意事项

3.4.1 单行注释符号作为字符串的一部分存在

当单行注释符号#作为字符串的一部分出现时，就不能再将它当做单行注释标记，而应该当做是字符串的一部分（字符串的字符），如下所示：

print(‘# 微信公众号：码农阿杰‘)
print("# 博客园博客地址 https://www.cnblogs.com/manongajie/""")
print("# CSDN 博客地址 https://blog.csdn.net/manongajie/")

运行结果：

# 微信公众号：码农阿杰
# 博客园博客地址 https://www.cnblogs.com/manongajie/
# CSDN 博客地址 https://blog.csdn.net/manongajie/

对以上代码说明：

  • Python 没有将井号#当做单行注释标记，而是将它当做字符串的一部分。

4 Python 多行注释

4.1 Python 多行注释概述

多行注释指的是一次性注释程序中多行代码，也可以是一行代码。

Python 中支持使用三个连续的单引号‘‘‘分别作为注释的开头和结尾，或者三个连续的双引号"""分别作为注释的开头和结尾，一次性注释多行或单行内容。

多行注释通常用来为 Python 函数、类、模块等等添加功能、版本和作者等描述信息。

4.2 三个连续的单引号注释

三个连续的单引号注释内容具体格式如下：

‘‘‘
使用三个连续的单引号分别作为注释的开头和结尾
可以一次性注释多行内容或单行内容
‘‘‘

4.3 三个连续的双引号注释

"""
使用三个连续的双引号分别作为注释的开头和结尾
可以一次性注释多行内容或单行内容
"""

4.4 多行注释也可以为函数提供说明文档

在 Python 中可以通过 help()内置函数或者__doc__属性查看某个函数的说明文档，如下代码所示：

# 查看 print() 内置函数的说明文档
print(‘--- 用 help()内置函数查看说明文档 ---‘)
help(print)
print(‘--- 用 __doc__ 属性查看说明文档 ---‘)
print(print.__doc__)

运行结果：

--- 用 help()内置函数查看说明文档 ---
Help on built-in function print in module builtins:

print(...)
    print(value, ..., sep=‘ ‘, end=‘\n‘, file=sys.stdout, flush=False)

    Prints the values to a stream, or to sys.stdout by default.
    Optional keyword arguments:
    file:  a file-like object (stream); defaults to the current sys.stdout.
    sep:   string inserted between values, default a space.
    end:   string appended after the last value, default a newline.
    flush: whether to forcibly flush the stream.

--- 用 __doc__ 属性查看说明文档 ---
print(value, ..., sep=‘ ‘, end=‘\n‘, file=sys.stdout, flush=False)

Prints the values to a stream, or to sys.stdout by default.
Optional keyword arguments:
file:  a file-like object (stream); defaults to the current sys.stdout.
sep:   string inserted between values, default a space.
end:   string appended after the last value, default a newline.
flush: whether to forcibly flush the stream.

其实，函数的说明文档，本质就是一段字符串（跟多行注释符号一致），都需要程序员自己编写，只不过作为说明文档，字符串的放置位置不同而已，函数的说明文档通常位于函数内部、所有代码的最前面。

如何为函数设置说明文档呢？如下所示：

# 定义一个比较数字大小的函数
def num_max(num1, num2):
    """
    比较两个数字的大小
    :param num1:形参1，数字1
    :param num2:形参2，数字2
    :return:大的数字，max_num = num1 if num1 > num2 else num2
    """
    max_num = num1 if num1 > num2 else num2
    return max_num

result = num_max(1, 2)
print(result)
print(‘--- 用 help() 内置函数查看 num_max() 的说明文档 ---‘)
help(num_max)
print(‘--- 用 __doc__ 属性查看 num_max() 的说明文档 ---‘)
print(num_max.__doc__)

运行结果：

2
--- 用 help() 内置函数查看 num_max() 的说明文档 ---
Help on function num_max in module __main__:

num_max(num1, num2)
    比较两个数字的大小
    :param num1:形参1，数字1
    :param num2:形参2，数字2
    :return:大的数字，max_num = num1 if num1 > num2 else num2

--- 用 __doc__ 属性查看 num_max() 的说明文档 ---

    比较两个数字的大小
    :param num1:形参1，数字1
    :param num2:形参2，数字2
    :return:大的数字，max_num = num1 if num1 > num2 else num2

4.5 多行注释注意事项

4.5.1 多行注释不支持嵌套

Python 多行注释不支持嵌套，如下所示为错误写法：

‘‘‘
外层注释
    ‘‘‘
    内层注释
    ‘‘‘
‘‘‘

4.5.2 多行注释符号‘‘‘或"""作为字符串标记

多行注释符号‘‘‘或"""也可以作为字符串的开始和结束标记。

Python 中当多行注释符号作为字符串的一部分出现时，就不能再将它们当做多行注释标记，而应该看做是字符串的一部分，如下所示：

str_info1 = ‘‘‘微信公众号：码农阿杰‘‘‘
str_info2 = """博客园博客地址 https://www.cnblogs.com/manongajie/"""
str_info3 = "CSDN 博客地址 https://blog.csdn.net/manongajie/"

print(str_info1)
print(str_info2)
print(str_info3)

运行结果：

微信公众号：码农阿杰
博客园博客地址 https://www.cnblogs.com/manongajie/
CSDN 博客地址 https://blog.csdn.net/manongajie/

对以上代码说明：

  • Python 没有将这里的三个引号当做是多行注释，而是将它们看作字符串的开始和结束标志。

5 文章其它地址

5.1 微信公众号：码农阿杰

5.2 CSDN博客

6 参考资料

6.1 Python 3.8.2 documentation

原文地址：https://www.cnblogs.com/manongajie/p/12656388.html

时间： 2024-08-06 21:35:15

Python 注释（Python Comments）用法详解的相关文章

Python中self的用法详解，或者总是提示：TypeError: add() missing 1 required positional argument: 'self'的问题解决

https://blog.csdn.net/songlh1234/article/details/83587086 下面总结一下self的用法详解,大家可以访问,可以针对平时踩过的坑更深入的了解下. https://blog.csdn.net/CLHugh/article/details/75000104, Python中self的用法详解,或者总是提示:TypeError: add() missing 1 required positional argument: 'self'的问题解决 原文

python OptParse模块的用法详解

OptParse模块的简单介绍 Python 有两个内建的模块用于处理命令行参数: 一个是 getopt只能简单处理 命令行参数: 另一个是 optparse,它功能强大,而且易于使用,可以方便地生成标准的.符合Unix/Posix 规范的命令行说明.会自动帮你负责-h帮助选项. 要自己定制程序的参数选项控制,可以使用python自带的OptParse模块,当然也可以直接解析sys.argv里的参数(但是此比较麻烦) import optparse optparse 现在不再更新了,更新版本叫

python os.path模块用法详解

abspath 返回一个目录的绝对路径 Return an absolute path. >>> os.path.abspath("/etc/sysconfig/selinux") '/etc/sysconfig/selinux' >>> os.getcwd() '/root' >>> os.path.abspath("python_modu") '/root/python_modu' basename 返回一个

python中enumerate()的用法详解【转摘】

enumerate()是python的内置函数.适用于python2.x和python3.xenumerate在字典上是枚举.列举的意思enumerate参数为可遍历/可迭代的对象(如列表.字符串)enumerate多用于在for循环中得到计数,利用它可以同时获得索引和值,即需要index和value值的时候可以使用enumerateenumerate()返回的是一个enumerate对象 >>> lst = [1, 2, 3, 4, 10, 5] >>> enumer

python中yield的用法详解——最简单，最清晰的解释

本文收自:冯爽朗 ,下面有博主名片 个人分类: python 首先我要吐槽一下,看程序的过程中遇见了yield这个关键字,然后百度的时候,发现没有一个能简单的让我懂的,讲起来真TM的都是头头是道,什么参数,什么传递的,还口口声声说自己的教程是最简单的,最浅显易懂的,我就想问没有有考虑过读者的感受. 接下来是正题: 首先,如果你还没有对yield有个初步分认识,那么你先把yield看做"return",这个是直观的,它首先是个return,普通的return是什么意思,就是在程序中返回某

Python可变参数函数用法详解

来自:http://c.biancheng.net/view/2257.html 很多编程语言都允许定义个数可变的参数,这样可以在调用函数时传入任意多个参数.Python 当然也不例外,Python 允许在形参前面添加一个星号(*),这样就意味着该参数可接收多个参数值,多个参数值被当成元组传入. 下面程序定义了一个形参个数可变的函数: # 定义了支持参数收集的函数 def test(a, *books) : print(books) # books被当成元组处理 for b in books :

Python中enumerate函数用法详解

enumerate函数用于遍历序列中的元素以及它们的下标,多用于在for循环中得到计数,enumerate参数为可遍历的变量,如 字符串,列表等 一般情况下对一个列表或数组既要遍历索引又要遍历元素时,会这样写: 1 2 for i in range (0,len(list)):    print i ,list[i] 但是这种方法有些累赘,使用内置enumerrate函数会有更加直接,优美的做法,先看看enumerate的定义: 1 2 3 4 5 6 7 def enumerate(colle

Python中yield的用法详解

首先我要吐槽一下,看程序的过程中遇见了yield这个关键字,然后百度的时候,发现没有一个能简单的让我懂的,讲起来真TM的都是头头是道,什么参数,什么传递的,还口口声声说自己的教程是最简单的,最浅显易懂的,我就想问没有有考虑过读者的感受. 接下来是正题: 首先,如果你还没有对yield有个初步分认识,那么你先把yield看做"return",这个是直观的,它首先是个return,普通的return是什么意思,就是在程序中返回某个值,返回之后程序就不再往下运行了.看做return之后再把它

Python实用技巧：global关键字的用法详解

这篇文章主要介绍了python global关键字的用法详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下: 想要更好的了解global关键字,首先要熟悉python的全局变量与局部变量的概念.global关键字的作用是可以申明一个局部变量为全局变量,下面看一下实例 一.变量作用域的说明 1.局部变量 1 def a(): 2 ## 菊部变量 - ,- 3 local = 1 4 print(local) 5 ## 全局无法使用,只有自己可用

python处理word文件:win32com用法详解

目标:用python处理doc文件 方法:引入win32com模块 ************************************************************************** 一.安装 ************************************************************************** 首先要先下载安装win32com模块(起先在linux下装不成功,后在windows下面成功了...) 下载地址:http