python整段代码注释-Python中注释(多行注释和单行注释)的用法实例
Python中注释(多行注释和单行注释)的用法实例
发布时间:2020-09-30 23:18:32
来源:脚本之家
阅读:97
前言
学会向程序中添加必要的注释,也是很重要的。注释不仅可以用来解释程序某些部分的作用和功能(用自然语言描述代码的功能),在必要时,还可以将代码临时移除,是调试程序的好帮手。
当然,添加注释的最大作用还是提高程序的可读性!很多时候,笔者宁愿自己写一个应用,也不愿意去改进别人的代码,没有合理的注释是一个重要原因。虽然良好的代码可自成文挡,但我们永远也不清楚今后读这段代码的人是谁,他是否和你有相同的思路。或者一段时间以后,你自己也不清楚当时写这段代码的目的了。
总的来说,一旦程序中注释掉某部分内容,则该内容将会被 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中注释(多行注释和单行注释)的用法实例相关推荐
- python pygame鼠标点击_Python中pygame的mouse鼠标事件用法实例
本文实例讲述了Python中pygame的mouse鼠标事件用法.分享给大家供大家参考,具体如下: pygame.mouse提供了一些方法获取鼠标设备当前的状态 ''' pygame.mouse.ge ...
- python中单行注释采用的符号是什么_Python注释符号使用说明(多行注释和单行注释),用法,详解,攻略...
Python 语言允许在任何地方插入空字符或注释,但不能插入到标识符和字符串中间. Python 源代码的注释有两种形式,分别是单行注释和多行注释: -单行注释-------------------- ...
- VS2019注释整段代码
VS2019注释整段代码 1.注释 先CTRL+K,然后CTRL+C 2.取消注释: 先CTRL+K,然后CTRL+U 顺便写一下: VS code注释整段代码 Alt Shift A 注释 Code ...
- python使用符号 表示单行注释-Python注释(多行注释和单行注释)用法详解
注释(Comments)用来向用户提示或解释某些代码的作用和功能,它可以出现在代码中的任何位置.Python 解释器在执行代码时会忽略注释,不做任何处理,就好像它不存在一样. 在调试(Debug)程序 ...
- pythonfor循环语句例子_值得收藏!16段代码入门Python循环语句
原标题:值得收藏!16段代码入门Python循环语句 导读:本文重点讲述for语句和while语句.for语句属于遍历循环,while语句属于当型循环.除了两个循环语句外,还介绍了break.cont ...
- 趣味Python | 223 段代码助你从入门到大师
(给机器学习算法与Python学习加星标,提升AI技能) 来源:知乎.个人主页等 本文转自AI新媒体量子位(公众号 ID: QbitAI) github:https://github.com/jack ...
- python整段注释_python段注释
广告关闭 腾讯云11.11云上盛惠 ,精选热门产品助力上云,云服务器首年88元起,买的越多返的越多,最高返5000元! 初学python习得注释方法如下:#我是注释print(hello) 我是多行注 ...
- python中怎么写注释_Python中注释的写法
Python中注释的写法 #:使用井号进行单行注释 Python中貌似没有提供多行注释,不过我们可以利用三引号的多行字符串来进行多行注释 """ 多行注释内容 多行注释内 ...
- php整段代码注释,PHP标准注释|单行注释|多行注释|规则方式
任何一门编程语言都有编程注释,注释的作用可以调试,可以描述代码的作用等等,说说那么PHP三种注释的方式 1, // 这是单行注释 2,# 这也是单行注释 3,/* */多行注释块 /* 这是多行注释块 ...
最新文章
- 玩转数据、拥抱智能 | 清华大学大数据能力提升项目宣讲会火热来袭
- Windows 技巧篇-设置我的漂亮桌面
- 为什么算法渐进复杂度中对数的底数总为2
- 微信卡券 - 微信公众平台 整理笔记
- ubuntu安装java的rpm_ubuntu安装jdk-6u45-linux-x64-rpm.bin
- IIS7 配置 PHP
- 画一画javascript原型链
- php对浮点数小数取整,php除法取整数
- 激活navicat提示rsa public key not find的问题
- 机器人主流编程语言盘点 及优缺点分析
- 浙江大学2019年数学分析考研试题
- 20分钟学会TCGA数据处理的视频链接
- CososCreator (Android)-AppLovin MAX 广告聚合平台接入+Firebase统计
- js加密大全(防止客户端查看自己的js文件)
- 甘松云未来计算机,2019年执业药师《中药学专业知识一》强化试题(10)
- GPU0和GPU1的区别
- qrcode生成固定大小的二维码
- 量子计算机 中国科学院,中科院量子计算机取得重大突破
- 3D立方体旋转相册特效
- 提取图片中的文字如何实现?两种方法均可操作!
热门文章
- 0.96寸OLED显示图片
- android11升级好卡怎么办,后悔升级:更新Android 11正式版后变卡了
- 北邮计算机学院男女比例,985大学男女比例,找对象有依据!
- 珠服务器维修,梦幻西游:最奇葩的服务器,避水珠比定魂珠贵10倍还供不应求...
- 中控考勤机web3.0登录账号密码
- 摄像机-哈苏-哈苏相机:哈苏相机
- vue中webpack5版本报错If you want to include a polyfill you need , If you don‘t want to include a polyfill
- oracle rollback作用,oracle中rollback语句作用范围
- 风控系统案例:中国移动
- Markus Persson:Minecraft 游戏背后的奇才