最新消息:XAMPP默认安装之后是很不安全的,我们只需要点击左方菜单的 "安全"选项,按照向导操作即可完成安全设置。

python注释:让更多的人读懂你的代码

XAMPP案例 admin 576浏览 0评论
学习任何一门编程语言的开始都需要学习它的注释怎么写,注释可以帮助我们理解代码的意图。
注释是啥?
计算机编程的本质就是传递信息,好的代码不仅能够把程序员的指令传递给计算机,还能够把程序员的意图传递给其他阅读代码的人。注释的存在正是为了帮助人们理解代码的意图,它不会对程序的行为产生任何影响。

python的两种注释
单行注释

在python中单行注释使用#,#后直到行尾的内容会被忽略,不会被python解释器执行。

drr85

多行注释

在python中多行注释使用一对三引号”’ ”’/””” “””(英文状态下),三引号之间的所有内容都会被忽略,不会被python解释器执行。

drr085

 

如何用好注释呢?
一个好的开发者的标志之一就是他的注释:在该注释的地方注释,在不需要注释的地方则不注释,甚至写得好的函数名本身就是一种注释。好的注释可以使我们更好地维护代码,一段时间之后依然可以更高效地回到代码高效开发。

注释这些内容:

整体架构,高层次的观点。

函数的用法。

重要的解决方案,特别是在不是很明显时。

避免注释:

描述“代码如何工作”和“代码做了什么”。

避免在代码已经足够简单或代码有很好的自描述性而不需要注释的情况下,还写些没必要的注释。

转载请注明:XAMPP中文组官网 » python注释:让更多的人读懂你的代码

您必须 登录 才能发表评论!