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