Python 中如何写注释
在写Python代码的时候,一个很好的编码实践就是使得你的代码简洁,易懂。组织代码,设置变量,以及给函数有意义的名字,都是几个不错的方法。
另外一个提高代码可读性的方式就是使用注释。一个注释就是可以用来解释代码的一段人类可读的解释或者一个注解。例如,如果你写了一个复杂的正则表达式,你可以添加一个注释,描述代码做了什么。
在你的Python代码中添加注释,在将来你阅读你的代码时,可以节省很多的时间和努力。比如说,你想修改一段你在几个月前或者几年前写的脚本。很可能你不记得为什么你写了一些比较复杂的代码,除非你添加一段注释。这个注释同时也可以帮助其他开发者理解你的代码,以及代码的目的。
注释应该很短,并且切中要点。不要解释那些很容易读懂的代码。
本文主要讲解在Python中编写注释的基础知识。
一、在Python中写注释
Python会忽略井号(#)后面的一切。
注释可以添加到行首或者和其他代码在一行。
#ThisisaPythoncomment. print("HelloWorld")#ThisisaninlinePythoncomment.
井号后面的空格不是强制性的,但是它会提高注释的可读性。
在字符串中间的井号并不意味着是一段注释的开始。此时,它仅仅是一个简单的井号。
paragraph="#Hashinsidequotesisnotacomment." Commentsshouldbeatthesameindentlevelasthecodebeneathit: ```py deffactorial(n): ifn==0: return1 else: #Usethefactorialfunction returnn*factorial(n-1)
如果你的文本编辑器支持语法高亮,注释通常都使用绿色代表。
注释在调试脚本的时候非常有用。与其删除一些行或者代码块,不如将他们暂时注释掉:
#forfruitinfruits: #print(fruit)
二、Python中的多行注释(注释块)
不像其他流行的编程语言,Python仅仅支持单行注释。
在Python中编写多行注释的最简单方式就是每行添加一个注释。
#Thisisthefirstline. #Thisisthesecondline.
另外一个选项就是使用docstrings
Docstrings是一个多行字符串,用来对模块,函数,类和方法进行文档化的。
一个Docstrings以(""")开始,可以是一行或者多行:
"""Thisis amultiline docstring. """
Docstrings不是技术性的注释。当Docstrings在模块,函数,类,或者方法的前面出现的时候,它在字节码中结束,并且变成__doc__特殊属性的对象。
你更应该使用单行注释。
三、Shebang
如果你阅读Python脚本,你可能注意到第一行以#!字符开始,接着是Python解释器的路径。
#!/usr/bin/envpython3
这一串字符串被称为shebang,它被用来告诉操作系统,应该使用什么解释器来解析文件。脚本以shebang开头,并且可以在终端中直接运行,而不用在脚本输入python。
因为shebang以井号开头,它被认为是一个注释,并且自动被Python解释器忽略。
四、总结
编写注释是一个非常好的实践,它帮助其他开发者,包括未来的自己,来理解这段代码在做什么。
在Python中,所有以井号开头的直到行末的,都被认为是一段注释。
以上就是Python中写注释的方法的详细内容,更多关于python注释的资料请关注毛票票其它相关文章!
声明:本文内容来源于网络,版权归原作者所有,内容由互联网用户自发贡献自行上传,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任。如果您发现有涉嫌版权的内容,欢迎发送邮件至:czq8825#qq.com(发邮件时,请将#更换为@)进行举报,并提供相关证据,一经查实,本站将立刻删除涉嫌侵权内容。