百科狗-知识改变命运!
--

Python编程规范的重要性

百变鹏仔1年前 (2023-11-21)阅读数 12#技术干货
文章标签注释

首先谈一下注释:

注释不止是为了自己以后看的更清楚,还是为了以后的开发人员所准备的,其实一段时间后,当需要对程序做一些修改或者是改正某个bug的时候,可能未来的我们自己都会忘记相关的细节,所以此时注释显得尤为重要。

每条注释以井号(#)开始,一直到该行末尾结束,一直到该行末尾结束。我们可以在注释中放任何东西,因为Python会完全无视他们的存在。为了写好注释,这里给出以后几条规则:

(1)假设读者的Python水平和你一样(比如说,不要去解释“什么是字符串”,也不要去解释“什么是赋值语句”)

(2)不要去注释那些毫无意义的事情。比如说:

count=count+1#addonetocount

(3)很多程序员会在代码上写上一些以“TODO”或者“FIXME”开始的注释,目的就是为了提醒他们回来编写或清理一些未完成的一些问题。

(4)如果你在编写某段程序的时候需要使劲思考的话,应该编写注释,以后别人不会在这个地方绞尽脑汁。尤其要注意的是,如果你在开发程序的时候或者函数编写的时候使用要点来描述,尽量写的细致一点,在开发工作完成之后,还应该将原来的要点全部保留下俩直接做解释。

(5)同样,如果某个bug很难查明,或者其修改方案比较复杂,那么你就应该编写一条注释对其进行解释。如果不这么做,那么今后其他复杂该部分的代码的程序员就会可能认定他们没有必要这么复杂并将其改为原来的样子,从而将你的心血付诸东流。

Python编程规范的重要性

(6)如果需要大量的注释才能解释清楚某段代码的作用,那么就应该对这些代码进行整理,比如,如果需要分别对一个函数的15个列表进行解释,那么就应该将该函数拆分成更小的代码块,每隔分别只处理较小的几个列表。

(7)过时的注释还不如没有注释,因此修改某段代码后,一定要检查相关注释,并对其做出适当的修改以保证其仍然能够准确描述代码的功能。

(8)注释不是越多越好,弄得整篇代码都是注释,却很少看到代码,这样就曲解了注释的意思了。

所以说,一定要养成良好的注释代码的习惯,边写代码边注释,及时的记录下来你的思路,举个例子,代码是鱼,注释就是水,有了正确的注释,鱼才能更好的生存。还有就是多提高自己对代码的解释能力,用精炼的语言表达出代码的核心价值所在,那么你写的代码就是成功的。

以上内容为大家介绍了Python编程规范的重要性,希望对大家有所帮助,如果想要了解更多Python相关知识,请关注IT培训机构:开发教育。

鹏仔微信 15129739599 鹏仔QQ344225443 鹏仔前端 pjxi.com 共享博客 sharedbk.com

免责声明:我们致力于保护作者版权,注重分享,当前被刊用文章因无法核实真实出处,未能及时与作者取得联系,或有版权异议的,请联系管理员,我们会立即处理! 部分文章是来自自研大数据AI进行生成,内容摘自(百度百科,百度知道,头条百科,中国民法典,刑法,牛津词典,新华词典,汉语词典,国家院校,科普平台)等数据,内容仅供学习参考,不准确地方联系删除处理!邮箱:344225443@qq.com)

图片声明:本站部分配图来自网络。本站只作为美观性配图使用,无任何非法侵犯第三方意图,一切解释权归图片著作权方,本站不承担任何责任。如有恶意碰瓷者,必当奉陪到底严惩不贷!

内容声明:本文中引用的各种信息及资料(包括但不限于文字、数据、图表及超链接等)均来源于该信息及资料的相关主体(包括但不限于公司、媒体、协会等机构)的官方网站或公开发表的信息。部分内容参考包括:(百度百科,百度知道,头条百科,中国民法典,刑法,牛津词典,新华词典,汉语词典,国家院校,科普平台)等数据,内容仅供参考使用,不准确地方联系删除处理!本站为非盈利性质站点,本着为中国教育事业出一份力,发布内容不收取任何费用也不接任何广告!)