python多行注释符号是什么(注释用法详解)
注释(Comments)用来向用户提示或解释某些代码的作用和功能,它可以出现在代码中的任何位置。Python解释器在执行代码时会忽略注释,不做任何处理,就好像它不存在一样。
在调试(Debug)程序的过程中,注释还可以用来临时移除无用的代码。
注释的最大作用是提高程序的可读性,没有注释的程序简直就是天书,让人吐血!
千万不要认为你自己写的代码规范就可以不加注释,甩给别人一段没有注释的代码是对别人的不尊重,是非常自私的行为;你可以喜欢自虐,但请不要虐待别人。
很多程序员宁愿自己去开发一个应用,也不愿意去修改别人的代码,没有合理的注释是一个重要的原因。虽然良好的代码可以自成文挡,但我们永远不清楚今后阅读这段代码的人是谁,他是否和你有相同的思路;或者一段时间以后,你自己也不清楚当时写这段代码的目的了。
一般情况下,合理的代码注释应该占源代码的1/3左右。
Python支持两种类型的注释,分别是单行注释和多行注释。
Python单行注释
Python使用井号#作为单行注释的符号,语法格式为:
#注释内容
从井号#开始,直到这行结束为止的所有内容都是注释。Python解释器遇到#时,会忽略它后面的整行内容。
说明多行代码的功能时一般将注释放在代码的上一行,例如:
#使用print输出字符串print("Hello World!") print("开课吧广场") print("https://topic.kaikeba.com/biancheng/python") #使用 print输出数字print(100) print( 3 + 100 * 2) print( (3 + 100) * 2 )12345678复制代码类型:[python]
说明单行代码的功能时一般将注释放在代码的右侧,例如:
print("https://topic.kaikeba.com/biancheng/python") #输出Python教程的地址print( 36.7 * 14.5 ) #输出乘积print( 100 % 7 ) #输出余数123复制代码类型:[html]
Python多行注释
多行注释指的是一次性注释程序中多行的内容(包含一行)。
Python使用三个连续的单引号'''或者三个连续的双引号"""注释多行内容,具体格式如下:
''' 使用 3 个单引号分别作为注释的开头和结尾 可以一次性注释多行内容 这里面的内容全部是注释内容 '''12345复制代码类型:[python]
或者
""" 使用 3 个双引号分别作为注释的开头和结尾 可以一次性注释多行内容 这里面的内容全部是注释内容 """12345复制代码类型:[python]
多行注释通常用来为Python文件、模块、类或者函数等添加版权或者功能描述信息。
注意事项
1)Python多行注释不支持嵌套,所以下面的写法是错误的:
''' 外层注释 '''内层注释 ''' '''123456复制代码类型:[python]
2)不管是多行注释还是单行注释,当注释符作为字符串的一部分出现时,就不能再将它们视为注释标记,而应该看做正常代码的一部分,例如:
print('''Hello,World!''') print("""https://topic.kaikeba.com/biancheng/python""") print("#是单行注释的开始")123复制代码类型:[html]
运行结果:
Hello,World! https://topic.kaikeba.com/biancheng/python#是单行注释的开始123复制代码类型:[html]
对于前两行代码,Python没有将这里的三个引号看作是多行注释,而是将它们看作字符串的开始和结束标志。
对于第3行代码,Python也没有将井号看作单行注释,而是将它看作字符串的一部分。
注释可以帮助调试程序
给代码添加说明是注释的基本作用,除此以外它还有另外一个实用的功能,就是用来调试程序。
举个例子,如果你觉得某段代码可能有问题,可以先把这段代码注释起来,让Python解释器忽略这段代码,然后再运行。如果程序可以正常执行,则可以说明错误就是由这段代码引起的;反之,如果依然出现相同的错误,则可以说明错误不是由这段代码引起的。
在调试程序的过程中使用注释可以缩小错误所在的范围,提高调试程序的效率。
原文地址:https://tangjiusheng.cn/it/5466.html
- jieba库怎么安装 (python安装jieba库详细步骤)
- Python return的用法(return语句用法和实践详解)
- python中def怎么用(def语法示例)
- python编程软件界面怎么调成中文版(pycharm英文版设置改成中文版)
- python保留两位小数(三种方法保留两位小数)
- Python中valueerror是什么错误(异常处理千万别这么干)
- python爬虫入门教程(五分钟学会Python网络爬虫)
- vscode python环境搭建(手把手教你详细步骤)
- python input函数用法(python把input变成数字)
- python运算符号的优先级别(一文搞懂算术运算符大全)