Python命名规则与注释风格

320阅读模式

命名规则

名称不要缩写!!!

名称不要缩写!!!文章源自懂站帝-http://www.sfdkj.com/12800.html

名称不要缩写!!!文章源自懂站帝-http://www.sfdkj.com/12800.html

包命名:小写,下划线_连接单词文章源自懂站帝-http://www.sfdkj.com/12800.html

模块命名:小写,下划线_连接单词文章源自懂站帝-http://www.sfdkj.com/12800.html

类命名:双驼峰,MyClass文章源自懂站帝-http://www.sfdkj.com/12800.html

函数命名:小写,下划线_连接单词文章源自懂站帝-http://www.sfdkj.com/12800.html

全局变量:每个字母大写文章源自懂站帝-http://www.sfdkj.com/12800.html

注释风格

注释很重要,要注明函数或类的功能,参数的数据类型、含义等。文章源自懂站帝-http://www.sfdkj.com/12800.html

注释模板:文章源自懂站帝-http://www.sfdkj.com/12800.html

'''All properties or methods that a function described文章源自懂站帝-http://www.sfdkj.com/12800.html

Parameters:文章源自懂站帝-http://www.sfdkj.com/12800.html

------文章源自懂站帝-http://www.sfdkj.com/12800.html

Args: type文章源自懂站帝-http://www.sfdkj.com/12800.html

description文章源自懂站帝-http://www.sfdkj.com/12800.html

Return:文章源自懂站帝-http://www.sfdkj.com/12800.html

------文章源自懂站帝-http://www.sfdkj.com/12800.html

variables: type文章源自懂站帝-http://www.sfdkj.com/12800.html

descripton文章源自懂站帝-http://www.sfdkj.com/12800.html

'''文章源自懂站帝-http://www.sfdkj.com/12800.html

注释的作用:文章源自懂站帝-http://www.sfdkj.com/12800.html

  • 注释要按格式写清楚,写全,避免在团队开发过程中不必要的沟通成本。
  • 在开发过程中,结合代码调试的结果和注释可以很快发现问题所在。

如何提高Python代码的可重复性?

Python有句话是do not repeat yourself,即不要做重复的事,因此出现了类或函数的封装和继承,基于此可提高代码的重复利用性。

懂站帝
  • 本文由 发表于 2022年5月9日 21:55:45
  • 版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至395045033@qq.com举报,一经查实,本站将立刻删除。
评论  0  访客  0