《Python Enhancement Proposal #8》 （8号python增强提案）又叫PEP8，他针对的python代码格式而编订的风格指南。

空白

  • 使用space来表示缩进，而不要用tab
  • 和语法相关的每一层缩进用4个空格来表示
  • 每行的字符数不应超过79
  • 文件中函数与类之间应该用两个空行隔开
  • 在同一个类中，各方法之间应用一个空行隔开
  • 在使用下表来获取列表元素、调用函数或给关键字参数赋值的时候，不要在两旁添加空格
  • 为变量赋值的时候，赋值符号的左侧和右侧应该各自写上一个空格，而且只要一个就好

命名

  • 函数、变量及属性应该用小写字母来拼写，各单词之间以下划线相连
  • 类与异常，应该以每个单词首字母均大写的格式来命名
  • 类中的实例方法，应该把首个参数命名为self,以表示该对象的自身
  • 类方法的首个参数，应该命名为cls,以表示该类自身

表达式和语句

  • 采用内联式的否定词，而不要把否定词放在整个表达式的前面，例如，应该写if a is not b 而不是if not a is b
  • 不要通过检测长度的办法（如 if len(somelist) == 0）来判断somelist是否为空值，而是应该采用 if not somelist 这种写法来判断，他会假定：空值将自动评估为False
  • 不要编写单行的if语句，for循环，while循环及except复合语句，而是应该把这些语句分成多行来书写，以示清晰
  • import语句应在总放在文件开头
  • 文件中的哪些import语句应该按照顺序划分为三个部分，分别表示标准库模块，第三方模块以及自用模块

要点

  • 当编写Python代码时，总应该遵循PEP8风格指南
  • 与广大Python开发者采用同一套代码风格，可以使项目更利于多人协作
  • 采用一直的风格来编写代码，可以领后续的修改工作变得更为容易