妙数

PEP8代码规范
PEP是Python Enhancement Proposal的缩写通常翻译为“Python增强提案”。每个PEP...
扫描右侧二维码阅读全文
23
2018/09

PEP8代码规范

PEP是Python Enhancement Proposal的缩写

通常翻译为“Python增强提案”。每个PEP都是一份为Python社区提供的指导Python往更好的方向发展的技术文档,其中的第8号增提案即PEP 8是针对Python语言编订的代码风格指南。

尽管我们可以在保证语法没有问题的前提下随意书写Python代码,但是在实际开发中,采用一致的风格书写出可读性强的代码是每个专业的程序员应该做到的事情,也是每个公司的编程规范中会提出的要求,这些在多人协作开发一个项目(团队开发)的时候显得尤为重要。

空格的使用

 1. 使用空格来表示缩进而不要用制表符(Tab)。
 2. 和语法相关的每一层缩进都用4个空格来表示。
 3. 每行的字符数不要超过79个字符,如果表达式因太长而占据了多行,除了首行之外的其余各行都应该在正常的缩进宽度上再加上4个空格。
 4. 函数和类的定义,代码前后都要用两个空行进行分隔。
 5. 在同一个类中,各个方法之间应该用一个空行进行分隔。
 6. 二元运算符的左右两侧应该保留一个空格,而且只要一个空格就好。

标识符命名

 1. 变量、函数和属性应该使用小写字母来拼写,如果有多个单词就使用下划线进行连接。
 2. 类中受保护的实例属性,应该以一个下划线开头。
 3. 类中私有的实例属性,应该以两个下划线开头。
 4. 类和异常的命名,应该每个单词首字母大写。
 5. 模块级别的常量,应该采用全大写字母,如果有多个单词就用下划线进行连接。
 6. 类的实例方法,应该把第一个参数命名为self以表示对象自身。
 7. 类的类方法,应该把第一个参数命名为cls以表示该类自身。

表达式和语句

 1. 采用内联形式的否定词,而不要把否定词放在整个表达式的前面。例如if a is not b就比if not a is b更容易让人理解。
 2. 不要用检查长度的方式来判断字符串、列表等是否为None或者没有元素,应该用if not x这样的写法来检查它。
 3. 就算if分支、for循环、except异常捕获等中只有一行代码,也不要将代码和if、for、except等写在一起,分开写才会让代码更清晰。
 4. import语句总是放在文件开头的地方。
 5. 引入模块的时候,from math import sqrt比import math更好。
 6. 如果有多个import语句,应该将其分为三部分,从上到下分别是Python标准模块、第三方模块和自定义模块,每个部分内部应该按照模块名称的字母表顺序来排列。
最后修改:2018 年 09 月 23 日 09 : 37 PM
如果觉得我的文章对你有用,请随意赞赏

发表评论