您当前的位置:首页 > 电脑百科 > 程序开发 > 语言 > Python

Python的代码书写规范、代码注释规范、代码命名规范详解

时间:2019-07-30 09:24:20  来源:  作者:

 

代码书写规范

缩进

统一使用 4 个空格进行缩进,不要混合使用制表符和空格来缩进,也不要单独使用制表符Tab。对于行连接的情况,可以垂直对齐换行的元素。

Python的代码书写规范、代码注释规范、代码命名规范详解

 


行宽

每行代码尽量不超过 80 个字符,在特殊情况下可以略微超过 80 ,如长的导入模块语句或注释里的URL。

Python会将圆括号、中括号和花括号中的行隐式的连接起来,可以利用这个特点,在表达式外围增加一对额外的圆括号,不要使用反斜杠连接行。

如果条件语句中条件过多,放在一行显得超长,可以使用圆括号来实现隐式连接,如下

Python的代码书写规范、代码注释规范、代码命名规范详解

 

如果一个文本字符串放在一行显得超长,可以使用圆括号来实现隐式行连接,如下:

Python的代码书写规范、代码注释规范、代码命名规范详解

 


引号

自然语言使用双引号,机器标示使用单引号,因此 代码里 多数应该使用 单引号。

  • 自然语言使用双引号
Python的代码书写规范、代码注释规范、代码命名规范详解

 

  • 机器标识使用单引号
Python的代码书写规范、代码注释规范、代码命名规范详解

 

  • 正则表达式使用双引号
Python的代码书写规范、代码注释规范、代码命名规范详解

 

  • 文档字符串 (Docstring)使用三双引号
Python的代码书写规范、代码注释规范、代码命名规范详解

 


空行

模块中类定义与函数之间空两行,类中各函数之间空一行,函数中可以使用空行分隔各逻辑代码块,使其更加清晰。

Python的代码书写规范、代码注释规范、代码命名规范详解

 


模块导入

每个独立模块导入应该独占一行,导入代码应该放在文件顶部,置于模块说明、文档字符串之后,全局变量、常量之前,模块导入建议顺序建议参考以一下顺序,每组之间使用一个空行分隔:

  • 标准库导入
  • 第三方库导入
  • 自定义库导入
Python的代码书写规范、代码注释规范、代码命名规范详解

 

同时,导入模块应尽量使用绝对导入。

Python的代码书写规范、代码注释规范、代码命名规范详解

 


空格

在二元操作符两边都加上一个空格,如 =,==, <, >, !=, <>, <=, >=, in, not in, is, is no,and, or, not。额外注意的是,当'='用于指示关键字参数或默认参数值时, 不要在其两侧使用空格。

Python的代码书写规范、代码注释规范、代码命名规范详解

 

函数的参数列表中“,”之后要有空格,但左括号之后,右括号之前不要加多余的空格。

Python的代码书写规范、代码注释规范、代码命名规范详解

 


Python的代码书写规范、代码注释规范、代码命名规范详解

 

代码注释规范

块注释

“#”号后空一格,段落间需要用空行分开。

Python的代码书写规范、代码注释规范、代码命名规范详解

 


行注释

行注释至少使用两个空格和语句分开。

Python的代码书写规范、代码注释规范、代码命名规范详解

 


文档注释——文档字符串Docstring

作为文档的Docstring一般出现在模块、函数和类的头部,Python中可以通过对象的__doc__属性获取文档字符串。Python中模块、类、函数、方法、生成器,应尽量写文档字符串。外部不可见的私有方法可以不写,但应该在 def 后提供一个块注释说明。文档注释以 """ 开头和结尾, 首行不换行, 如有多行, 末行必需换行。

Python的代码书写规范、代码注释规范、代码命名规范详解

 

对函数的注释说明,建议参考如下注释规范,如下所示:

Python的代码书写规范、代码注释规范、代码命名规范详解

 


 

代码命名规范

模块命名

模块使用小写字母命名,首字母保持小写,尽量不要用下划线。

Python的代码书写规范、代码注释规范、代码命名规范详解

 


类名命名

类名使用驼峰命名风格,首字母大写。

Python的代码书写规范、代码注释规范、代码命名规范详解

 


函数命名

函数名全部采用小写字母,如有多个单词,用下划线隔开。

Python的代码书写规范、代码注释规范、代码命名规范详解

 


变量命名

变量名尽量使用小写字母,常量采用全大写字母,如有多个单词,用下划线隔开。

Python的代码书写规范、代码注释规范、代码命名规范详解

 



Tags:Python 书写规范   点击:()  评论:()
声明:本站部分内容及图片来自互联网,转载是出于传递更多信息之目的,内容观点仅代表作者本人,如有任何标注错误或版权侵犯请与我们联系(Email:2595517585@qq.com),我们将及时更正、删除,谢谢。
▌相关推荐
代码书写规范缩进统一使用 4 个空格进行缩进,不要混合使用制表符和空格来缩进,也不要单独使用制表符Tab。对于行连接的情况,可以垂直对齐换行的元素。 行宽每行代码尽量不超...【详细内容】
2019-07-30  Tags: Python 书写规范  点击:(355)  评论:(0)  加入收藏
▌简易百科推荐
大家好,我是菜鸟哥,今天跟大家一起聊一下Python4的话题! 从2020年的1月1号开始,Python官方正式的停止了对于Python2的维护。Python也正式的进入了Python3的时代。而随着时间的...【详细内容】
2021-12-28  菜鸟学python    Tags:Python4   点击:(1)  评论:(0)  加入收藏
学习Python的初衷是因为它的实践的便捷性,几乎计算机上能完成的各种操作都能在Python上找到解决途径。平时工作需要在线学习。而在线学习的复杂性经常让人抓狂。费时费力且效...【详细内容】
2021-12-28  风度翩翩的Python    Tags:Python   点击:(1)  评论:(0)  加入收藏
Python 是一个很棒的语言。它是世界上发展最快的编程语言之一。它一次又一次地证明了在开发人员职位中和跨行业的数据科学职位中的实用性。整个 Python 及其库的生态系统使...【详细内容】
2021-12-27  IT资料库    Tags:Python 库   点击:(2)  评论:(0)  加入收藏
菜单驱动程序简介菜单驱动程序是通过显示选项列表从用户那里获取输入并允许用户从选项列表中选择输入的程序。菜单驱动程序的一个简单示例是 ATM(自动取款机)。在交易的情况下...【详细内容】
2021-12-27  子冉爱python    Tags:Python   点击:(4)  评论:(0)  加入收藏
有不少同学学完Python后仍然很难将其灵活运用。我整理15个Python入门的小程序。在实践中应用Python会有事半功倍的效果。01 实现二元二次函数实现数学里的二元二次函数:f(x,...【详细内容】
2021-12-22  程序汪小成    Tags:Python入门   点击:(32)  评论:(0)  加入收藏
Verilog是由一个个module组成的,下面是其中一个module在网表中的样子,我只需要提取module名字、实例化关系。module rst_filter ( ...); 端口声明... wire定义......【详细内容】
2021-12-22  编程啊青    Tags:Verilog   点击:(9)  评论:(0)  加入收藏
运行环境 如何从 MP4 视频中提取帧 将帧变成 GIF 创建 MP4 到 GIF GUI ...【详细内容】
2021-12-22  修道猿    Tags:Python   点击:(6)  评论:(0)  加入收藏
面向对象:Object Oriented Programming,简称OOP,即面向对象程序设计。类(Class)和对象(Object)类是用来描述具有相同属性和方法对象的集合。对象是类的具体实例。比如,学生都有...【详细内容】
2021-12-22  我头秃了    Tags:python   点击:(9)  评论:(0)  加入收藏
所谓内置函数,就是Python提供的, 可以直接拿来直接用的函数,比如大家熟悉的print,range、input等,也有不是很熟,但是很重要的,如enumerate、zip、join等,Python内置的这些函数非常...【详细内容】
2021-12-21  程序员小新ds    Tags:python初   点击:(5)  评论:(0)  加入收藏
Hi,大家好。我们在接口自动化测试项目中,有时候需要一些加密。今天给大伙介绍Python实现各种 加密 ,接口加解密再也不愁。目录一、项目加解密需求分析六、Python加密库PyCrypto...【详细内容】
2021-12-21  Python可乐    Tags:Python   点击:(8)  评论:(0)  加入收藏
最新更新
栏目热门
栏目头条