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


Posted in Python onAugust 28, 2019

前言

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

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

总的来说,一旦程序中注释掉某部分内容,则该内容将会被 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 解释器忽略这段代码,然后运行。如果程序可以正常执行,则可以说明错误就是由这段代码引起的;反之,如果依然出现相同的错误,则可以说明错误不是由这段代码引起的。

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

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,谢谢大家对三水点靠木的支持。

Python 相关文章推荐
Python实现控制台输入密码的方法
May 29 Python
Python如何判断数独是否合法
Sep 08 Python
python中类变量与成员变量的使用注意点总结
Apr 29 Python
Python列表list内建函数用法实例分析【insert、remove、index、pop等】
Jul 24 Python
使用python验证代理ip是否可用的实现方法
Jul 25 Python
浅析Python与Mongodb数据库之间的操作方法
Jul 01 Python
python tkinter基本属性详解
Sep 16 Python
Tensorflow 实现分批量读取数据
Jan 04 Python
pyinstaller 3.6版本通过pip安装失败的解决办法(推荐)
Jan 18 Python
python批量替换文件名中的共同字符实例
Mar 05 Python
python 实现仿微信聊天时间格式化显示的代码
Apr 17 Python
python3的pip路径在哪
Jun 23 Python
对Django的restful用法详解(自带的增删改查)
Aug 28 #Python
Python closure闭包解释及其注意点详解
Aug 28 #Python
python opencv调用笔记本摄像头
Aug 28 #Python
Python threading的使用方法解析
Aug 28 #Python
Numpy对数组的操作:创建、变形(升降维等)、计算、取值、复制、分割、合并
Aug 28 #Python
Python logging设置和logger解析
Aug 28 #Python
Python shelve模块实现解析
Aug 28 #Python
You might like
PHP中如何实现常用邮箱的基本判断
2014/01/07 PHP
Zend Framework入门教程之Zend_Db数据库操作详解
2016/12/08 PHP
PHP使用Redis长连接的方法详解
2018/02/12 PHP
showModelessDialog()使用详解
2006/09/21 Javascript
一个轻量级的javascript库 pj介绍
2010/12/19 Javascript
js验证IP及子网掩码的合法性有效性示例
2014/04/30 Javascript
javascript实现阻止iOS APP中的链接打开Safari浏览器
2014/06/12 Javascript
jQuery实现动画效果circle实例
2015/08/06 Javascript
js实现鼠标点击文本框自动选中内容的方法
2015/08/20 Javascript
jquery实现百叶窗效果
2017/01/12 Javascript
详解angularJS+Ionic移动端图片上传的解决办法
2017/09/13 Javascript
javascript实现5秒倒计时并跳转功能
2019/06/20 Javascript
有关vue 开发钉钉 H5 微应用 dd.ready() 不执行问题及快速解决方案
2020/05/09 Javascript
[03:48]2014DOTA2 TI专访71DK夺冠不靠小组赛高排名
2014/07/11 DOTA
Python按行读取文件的简单实现方法
2016/06/22 Python
Python处理JSON时的值报错及编码报错的两则解决实录
2016/06/26 Python
python构建深度神经网络(DNN)
2018/03/10 Python
django中模板的html自动转意方法
2018/05/27 Python
使用 Python 实现文件递归遍历的三种方式
2018/07/18 Python
在Python中居然可以定义两个同名通参数的函数
2019/01/31 Python
Python3.5文件读与写操作经典实例详解
2019/05/01 Python
python实现猜数字游戏
2020/03/25 Python
python__name__原理及用法详解
2019/11/02 Python
python GUI库图形界面开发之PyQt5布局控件QHBoxLayout详细使用方法与实例
2020/03/06 Python
Python sql注入 过滤字符串的非法字符实例
2020/04/03 Python
win10从零安装配置pytorch全过程图文详解
2020/05/08 Python
利用python下载scihub成文献为PDF操作
2020/07/09 Python
Cpython解释器中的GIL全局解释器锁
2020/11/09 Python
PyCharm 光标变成黑块的解决方式
2021/02/06 Python
双立人加拿大官网:Zwilling加拿大
2020/08/10 全球购物
函授本科自我鉴定
2013/11/03 职场文书
中药专业自荐信范文
2014/03/18 职场文书
数控技校生自我鉴定
2014/04/19 职场文书
挂牌仪式策划方案
2014/05/18 职场文书
员工工作表扬信
2015/05/05 职场文书
公司行政管理制度范本
2015/08/05 职场文书