python——PEP8风格代码规范指南

空白

python中的空白（whitespace）会影响代码含义。程序员在使用空白的时候需要注意，因为会影响到代码的清晰程度。

• 使用space（空格）来表示缩进，而不要用tab（制表符）。
• 和语法相关的每一层缩进都用4个空格来表示。
• 每行的字符数不应超过79
• 对于占据多行的长表达式来说，除了首行之外的其余各行都应该在通常的缩进级别之上再加4个空格。
• 文件中的函数与类之间应该用两个空行隔开。
• 在同一个类中，各方法之间应该用一个空行隔开。
• 在使用下标来获取列表元素、调用函数或给关键字参数赋值的时候，不要再两旁添加空格。
• 为变量赋值的时候，赋值符号的左侧和右侧应该各自协商一个空格，而且只写一个就好。

命名

PEP8提倡采用不同的命名风格来编写python代码的各个部分，以便在阅读代码时可以根据这些名称看出它们在python语言中的角色。

• 函数、变量及属性应该用小写字母来拼写，各单词之间用下划线相连，例如，lowercase_underscore。
• 受保护的实例属性，应该以单个下划线开头，例如，_leading_underscrore。
• 私有的实例属性，应该以两个下划线开头，例如，__double_leading_underscore。
• 类与异常，应该以每个单词首字母大写的形式来命名，例如，CapitalizedWord。
• 模块级别的常量，应该全部采用大写字母来拼写，各单词之间以下划线相连，例如，ALL_CAPS。
• 类中的实例方法（instance method），应该把首个参数命名为self，以表示该对象自身。
• 类方法（class method）的首个参数，应该命名为cls，以表示该类自身。

表达式和语句

《The Zen of Python