ICode9

精准搜索请尝试: 精确搜索
首页 > 编程语言> 文章详细

Python注释(多行注释和单行注释)用法详解

2021-05-30 19:33:06  阅读:186  来源: 互联网

标签:多行 Python 代码 注释 单行 详解 print


Python注释(多行注释和单行注释)用法详解

  • 注释(Comments)用来向用户提示或解释某些代码的作用和功能,它可以出现在代码中的任何位置。Python 解释器在执行代码时会忽略注释,不做任何处理,就好像它不存在一样。
  • 在调试(Debug)程序的过程中,注释还可以用来临时移除无用的代码。
  • 注释的最大作用是提高程序的可读性,没有注释的程序简直就是天书,让人吐血!
  • 千万不要认为你自己写的代码规范就可以不加注释,甩给别人一段没有注释的代码是对别人的不尊重,是非常自私的行为;你可以喜欢自虐,但请不要虐待别人。
  • 很多程序员宁愿自己去开发一个应用,也不愿意去修改别人的代码,没有合理的注释是一个重要的原因。虽然良好的代码可以自成文挡,但我们永远不清楚今后阅读这段代码的人是谁,他是否和你有相同的思路;或者一段时间以后,你自己也不清楚当时写这段代码的目的了。
  • 一般情况下,合理的代码注释应该占源代码的 1/3 左右。
  • Python 支持两种类型的注释,分别是单行注释和多行注释。

Python 单行注释

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

# 注释内容

井号#开始,直到这行结束为止的所有内容都是注释。Python 解释器遇到#时,会忽略它后面的整行内容。

说明多行代码的功能时一般将注释放在代码的上一行,例如:

#使用print输出字符串
print("Hello World!")
print("C语言中文网")
print("http://c.biancheng.net/python/")
#使用 print输出数字
print(100)
print( 3 + 100 * 2)
print( (3 + 100) * 2 )

说明单行代码的功能时一般将注释放在代码的右侧,例如:

print("http://c.biancheng.net/python/")  #输出Python教程的地址
print( 36.7 * 14.5 )  #输出乘积
print( 100 % 7 )  #输出余数

Python 多行注释

  • 多行注释指的是一次性注释程序中多行的内容(包含一行)。
  • Python 使用三个连续的单引号’’'或者三个连续的双引号"""注释多行内容,具体格式如下:
'''
使用 3 个单引号分别作为注释的开头和结尾
可以一次性注释多行内容
这里面的内容全部是注释内容
'''

或者

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

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

注意事项

  1. Python 多行注释不支持嵌套,所以下面的写法是错误的:
'''
外层注释
    '''
    内层注释
    '''
'''
  1. 不管是多行注释还是单行注释,当注释符作为字符串的一部分出现时,就不能再将它们视为注释标记,而应该看做正常代码的一部分,例如:
print('''Hello,World!''')
print("""http://c.biancheng.net/cplus/""")
print("#是单行注释的开始")

运行结果:
Hello,World!
http://c.biancheng.net/cplus/
#是单行注释的开始

  • 对于前两行代码,Python 没有将这里的三个引号看作是多行注释,而是将它们看作字符串的开始和结束标志。
  • 对于第 3 行代码,Python 也没有将井号看作单行注释,而是将它看作字符串的一部分。

注释可以帮助调试程序

  • 给代码添加说明是注释的基本作用,除此以外它还有另外一个实用的功能,就是用来调试程序。
  • 举个例子,如果你觉得某段代码可能有问题,可以先把这段代码注释起来,让 Python 解释器忽略这段代码,然后再运行。如果程序可以正常执行,则可以说明错误就是由这段代码引起的;反之,如果依然出现相同的错误,则可以说明错误不是由这段代码引起的。
  • 在调试程序的过程中使用注释可以缩小错误所在的范围,提高调试程序的效率。

标签:多行,Python,代码,注释,单行,详解,print
来源: https://blog.csdn.net/yelitoudu/article/details/117402987

本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享;
2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关;
3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关;
4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除;
5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

专注分享技术,共同学习,共同进步。侵权联系[81616952@qq.com]

Copyright (C)ICode9.com, All Rights Reserved.

ICode9版权所有