Python开发中高频代码的pep8规范

代码规范是衡量一个程序员编码能力的最最直接标准，就像人与人之间首先看外表一样。

每级缩进用4个空格。

括号中使用垂直隐式缩进或使用悬挂缩进。后者应该注意第一行要没有参数，后续行要有缩进。

Yes

No

4个空格的规则是对续行可选的。

右边括号也可以另起一行。有两种格式，建议第2种。

空格或Tab?

空格是首选的缩进方法。

Tab仅仅在已经使用tab缩进的代码中为了保持一致性而使用。

Python 3中不允许混合使用Tab和空格缩进。

Python 2的包含空格与Tab和空格缩进的应该全部转为空格缩进。

最大行宽

限制所有行的最大行宽为79字符。

文本长块，比如文档字符串或注释，行长度应限制为72个字符。

空行

两行空行分割顶层函数和类的定义。

类的方法定义用单个空行分割。

额外的空行可以必要的时候用于分割不同的函数组，但是要尽量节约使用。

额外的空行可以必要的时候在函数中用于分割不同的逻辑块，但是要尽量节约使用。

源文件编码

在核心Python发布的代码应该总是使用UTF-8(ASCII在Python 2)。

Python 3(默认UTF-8)不应有编码声明。

导入在单独行

Yes：

No:

导入始终在文件的顶部，在模块注释和文档字符串之后，在模块全局变量和常量之前。

导入顺序如下：标准库进口,相关的第三方库，本地库。各组的导入之间要有空行。

禁止使用通配符导入。

通配符导入(fromimport *)应该避免，因为它不清楚命名空间有哪些名称存，混淆读者和许多自动化的工具。

字符串引用

Python中单引号字符串和双引号字符串都是相同的。注意尽量避免在字符串中的反斜杠以提高可读性。

根据PEP 257, 三个引号都使用双引号。

括号里边避免空格

逗号，冒号，分号之前避免空格

索引操作中的冒号当作操作符处理前后要有同样的空格(一个空格或者没有空格，个人建议是没有。)

函数调用的左括号之前不能有空格

赋值等操作符前后不能因为对齐而添加多个空格

二元运算符两边放置一个空格

涉及 =、符合操作符 ( += , -=等)、比较( == , , != , , = , in , not in , is , is not )、布尔( and , or , not )。

优先级高的运算符或操作符的前后不建议有空格。

关键字参数和默认值参数的前后不要加空格

通常不推荐复合语句(Compound statements: 多条语句写在同一行)。

尽管有时可以在if/for/while 的同一行跟一小段代码，但绝不要跟多个子句，并尽量避免换行。

避免采用的名字

决不要用字符'l'(小写字母el)，'O'(大写字母oh)，或 'I'(大写字母eye) 作为单个字符的变量名。一些字体中，这些字符不能与数字1和0区别。用'L' 代替'l'时。

包和模块名

模块名要简短，全部用小写字母，可使用下划线以提高可读性。包名和模块名类似，但不推荐使用下划线。