PEP8:令你的python代码更易读

2021-06-03 17:39:16 浏览数 (2)

许多小伙伴们在使用具有代码分析的代码编辑器写 python 代码的时候,有时候会遇到这种情况:明明代码没有错误,也可以进行代码执行,为什么代码下面还画着波浪线?其实是因为你的代码不符合 PEP8 规范。虽然不符合该规范代码也可以正常运行(大多数情况可以正常运行),但乱七八糟的代码会是阅读代码的人难以理解代码,所以为了小伙伴的同事关系融洽(不宜读的代码会增加别人的负担),学习 PEP8 规范很有必要。

首先介绍一下 PEP8,它是 Guido(python 之父)写的 python 样式指南文章改编而来(加入 Barry 的部分样式指南)的编码约定。详细的 PEP8 文档可以在官网找到。

PEP8官网文档

接下来,小编挑出一些平常比较需要注意的规范进行介绍:

缩进

每一级缩进使用4个空格(可以在代码编辑 tab 制表符一次缩进四个空格)。

续行

续行应该与其包裹元素对齐。

可以使用圆括号、方括号和花括号内的隐式行连接来垂直对齐,也可以使用挂行缩进对齐。

注:在使用挂行缩进时,应该考虑到第一行不应该有参数,以及使用缩进以区分自己是续行。

行的最大长度

所有行限制的最大字符数为79。超出最大字符数可以采用续行。

没有结构化限制的大块文本(比如文档字符或者注释),每行的最大字符数限制在72。

空行

顶层函数和类的定义,前后使用两个空行隔开。

类里的方法定义只需要用一个空行隔开。

导入

导入通常要分开进行而且要位于文件的顶部。

注释

块注释使用一个 # 和一个空格加上注释内容构成。块注释最好缩进到与代码相同的级别(尽管不缩进也不会被代码编辑器发现)。

行内注释则是在块注释的要求上在 # 之前空两个空格。

注;代码编辑器不会关注你的注释的质量,但这并不代表你可以随意注释,垃圾的注释不如没有注释。

命名约定

在命名的时候应该避免一些不好区分的字母作为单字符变量名(比如小写的 L 和大写的 i,当然,这点也不会被代码编辑器发现)。

类名一般使用首字母大写,函数名应该小写,想提高可读性可以用下划线分隔

不要加分号

尽管在 python2.x 版本中可以使用分号来作为语句的结束标识,但实际上 python 还是通过换行来识别语句结束。所以分号不需要存在,也不要在一行里写入多个 python 语句(因为使用分号可以在一行内写入多个语句,但这是违背 PEP8 规范的)。

空格

按照标准的排版规范来使用标点两边的空格,括号内不要有空格。不要在逗号,分号,冒号前加空格,但应该在他们后面加空格(行尾除外)。

参数列表, 索引或切片的左括号前不应加空格。 在二元操作符两边都加上一个空格, 比如赋值(=), 比较(==, <, >, !=, <>, <=, >=, in, not in, is, is not)和布尔(and, or, not)。算术操作符两边的空格应该保持一致。当(=)用于指示关键字参数或默认参数值时, 不要在其两侧使用空格。 

总结

PEP8 代码规范虽然很多很复杂,但有些规则你多使用自然就能成为习惯。当编写的代码符合规范时,代码的可阅读性就大大提高了。另外,使用一款好的代码编辑器可以帮助你发现不符合 PEP8 规范的地方,并给出相应的提示(比如 pycharm)。

更多优质 python 课程,尽在Python课程列表


0 人点赞