Python中注释(多行注释和单行注释)的用法实例

作者:daisy 时间:2023-07-04 15:05:01 

前言

学会向程序中添加必要的注释,也是很重要的。注释不仅可以用来解释程序某些部分的作用和功能(用自然语言描述代码的功能),在必要时,还可以将代码临时移除,是调试程序的好帮手。

当然,添加注释的最大作用还是提高程序的可读性!很多时候,笔者宁愿自己写一个应用,也不愿意去改进别人的代码,没有合理的注释是一个重要原因。虽然良好的代码可自成文挡,但我们永远也不清楚今后读这段代码的人是谁,他是否和你有相同的思路。或者一段时间以后,你自己也不清楚当时写这段代码的目的了。

总的来说,一旦程序中注释掉某部分内容,则该内容将会被 Python 解释器忽略,换句话说,此部分内容将不会被执行。

通常而言,合理的代码注释应该占源代码的 1/3 左右。Python 语言允许在任何地方插入空字符或注释,但不能插入到标识符和字符串中间。

在 Python 中,通常包括 3 种类型的注释,分别是单行注释、多行注释和中文编码声明注释。

Python单行注释

Python 中使用井号(‘#')作为单行注释的符号,语法格式为:

# 注释内容

也就是说,从符号‘#'处开始,直到换行处结束,此部分内容都作为注释的内容,当程序执行时,这部分内容会被忽略。

单行注释放置的位置,既可以是要注释代码的前一行,例如:


#这是一行简单的注释
print ("Hello World!")

也可以是注释代码的右侧,例如:


print ("Hello World!") #这是一行简单的注释

基于注释在程序中所起到的作用,以上两种方式虽然放置位置不同,但程序的执行结果是相同的,都是输出“Hello World!”。

Python多行注释

多行注释指的是可以一次性注释程序中多行的内容(包含一行)。多行注释的语法有 2 种,分别是:


'''
使用 3 个单引号分别作为注释的开头和结尾
可以一次性注释多行内容
这里面的内容全部是注释内容
'''

或者


"""
使用 3 个双引号分别作为注释的开头和结尾
可以一次性注释多行内容
这里面的内容全部是注释内容
"""

多行注释通常用来为 Python 文件、模块、类或者函数等添加版权、功能描述等信息。需要注意的是,在 Python 中,如果多行注释标记(三单引号或三双引号)作为语句的一部分出现,就不能再将它们视为多行注释的标记,而应看做是字符串的标志(同双引号的作用相同),例如:


print('''Hello,World!''')

该语句的执行结果为:Hello,World!。由此可见,Python 解释器没有将这里的三个单引号看做是注释,而是将它们看作是字符串的标志。

Python中文编码声明注释

Python 还提供了一种特殊的中文编码声明注释,其主要用来解决 Python 2.x 中不支持直接写中文的问题。虽然此问题在 Python 3.x 中已经不存在啦,但为了规范编码,增强代码的可执行性,方便其他程序员及时了解程序所用的编码,建议初学者在程序开头处加上中文编码声明注释。

中文编码声明注释的语法有如下 2 种:


# -*- coding:编码 -*-
或者
# coding=编码

语法中的编码,指的是编写程序所用的字符编码类型,比如 UTF-8、GBK 编码等。另外,在第一种语法中,‘-*-'并没有实际意义,只是为了美观才加上去了,因此,第一种语法格式中可以直接将前后的‘-*-'去掉。

举个例子,如果指定编码为 UTF-8,则可以使用下面的中文编码声明注释:


# coding:utf-8
或者
# coding=utf-8

注意,给代码添加注释是是注释的基本用法,它还有一个更实用的功能,即用来调试程序。举个例子,如果你觉得某段代码可能有问题,可以先把这段代码注释起来,让 Python 解释器忽略这段代码,然后运行。如果程序可以正常执行,则可以说明错误就是由这段代码引起的;反之,如果依然出现相同的错误,则可以说明错误不是由这段代码引起的。

由此可见,在调试程序时,学会注释代码,可以缩小错误所在的范围,提高调试程序的效率。

来源:http://c.biancheng.net/view/2170.html

标签:python,多行,注释
0
投稿

猜你喜欢

  • keras 读取多标签图像数据方式

    2021-01-30 18:26:48
  • PDO::getAttribute讲解

    2023-06-06 02:58:22
  • 详解如何将本地项目上传到Github的方法步骤(图文)

    2023-12-07 23:21:31
  • 一步步教你在Navicat上如何停止正在运行的MYSQL语句

    2024-01-21 06:17:01
  • Vue简易版无限加载组件实现原理与示例代码

    2024-04-28 10:54:53
  • SQLServer 快速备份的十种方法

    2024-01-21 01:04:32
  • javascript div 遮罩层封锁整个页面

    2024-06-09 01:20:09
  • python urllib库的使用详解

    2021-06-12 14:42:04
  • Python操作sqlite3快速、安全插入数据(防注入)的实例

    2022-04-22 16:38:14
  • Python基于Google Bard实现交互式聊天机器人

    2022-12-14 22:05:20
  • 使用python实现两数之和的画解算法

    2022-01-04 21:06:05
  • python根据出生日期获得年龄的方法

    2022-05-22 23:52:46
  • 提高代码可读性的十大注释技巧分享

    2023-05-28 21:55:35
  • Python制作进度条的四种方法总结

    2022-05-30 05:21:00
  • php线性表顺序存储实现代码(增删查改)

    2023-11-19 06:51:53
  • 举例讲解Linux系统下Python调用系统Shell的方法

    2023-08-25 00:04:46
  • 浅谈用Go构建不可变的数据结构的方法

    2024-04-26 17:36:27
  • sqlserver 多表关联时在where语句中慎用trim()方法

    2024-01-16 06:37:32
  • Python 关于反射和类的特殊成员方法

    2021-10-16 19:30:13
  • python实现加密的方式总结

    2023-08-28 05:36:58
  • asp之家 网络编程 m.aspxhome.com