Python最简编码规范

0、前言

本文是阅读《Python Coding Rule》之后总结的最为精华及简单的编码规范，根据每个人不同喜好有些地方会有不同的选择，我只是做了对自己来说最简单易行的选择，仅供大家参考。

1、重要原则

1. 保持风格的一致性很重要，但最重要的是：知道何时不一致
2. 打破一条既定规则的两个好理由：
   当应用规则会导致代码可读性下降(可读性赛高)
   • 为了和周围代码保持一致而打破规则(历史遗留)

2、最简规范

• 只使用空格缩进
• 使用UTF-8编码
• 每行只写一条语句
• 使用行末反斜杠折叠长行，限制每行最大79字符
• 导入包：每行唯一、从大到小、绝对路径
• 类内方法空1行分隔，类外空2行分隔
• 运算符除 * 外，两边空1格分隔，函数参数=周围不用空格
• 除类名使用驼峰法以外，其他模块、函数、方法、变量均使用全小写+下划线
• 1个前导下划线表示半公开，2个前导下划线表示私有，与保留字区分使用单个后置下划线
• 开发时使用中文注释，发布时再写英文文档

3、详细规范

• 全文通用
• 只使用空格缩进，4个空格表示1个缩进层次
• 每行长度限制在79字符内，使用行末反斜杠折叠长行
• 使用UTF-8编码
• 每行只写一条语句

4、代码命名

• 一行只import一个包，imports的顺序为：标准库、相关主包、特定应用，每组导入之间放置1行空行，所有导入使用包的绝对路径。
• 分割顶层函数和类的定义使用2行空行，分割类内方法定义使用1行空行，class行与第一个方法定义之间要有1行空行。
• 整体使用英文书写方式来使用空格，即仅在

  逗号、分号后面添加1个空格

  ，其他任何符号如

  圆括号、方括号、花括号等都不用空格

  把符号与字符分开，写在一起表示一个整体;运算符除

  *

  号以外，其他符号两边都各用1个空格分隔;函数参数

  =

  号周围不用空格。
• 模块名：不含下划线、简短、全小写;
• 类名、异常名：首字母大写单词串的驼峰法;
• 函数名、全局变量名、方法名、实例变量：全小写，加下划线增加可读性;
• 一个前导下划线仅用于不想被导入的全局变量(还有内部函数和类)前加一个下划线)、不打算作为类的公共接口的内部方法和实例变量;
• 两个前导下划线以表示类私有的名字，只用来避免与类(为可以子类化所设计)中的属性发生名字冲突。
• 私有属性必须有两个前导下划线，无后置下划线;
• 非公有属性必须有一个前导下划线，无后置下划线。
• 公共属性没有前导和后置下划线，除非它们与保留字冲突，此情况下，单个后置下划线比前置或混乱的拼写要好，例如:class_优于klass。

5、编写技巧

• 与None之类的单值比较，永远用:'is'或'is not'来做：if x is not None
• 在模块和包内定义基异常类(base exception class)
• 使用字符串方法(methods)代替字符串模块。
  
• 在检查前缀或后缀时避免对字符串进行切片，用startswith()和endswith()代替，如：No: if foo[:3] == 'bar':Yes: if foo.startswith('bar'):
• 只用isinstance()进行对象类型的比较，如： No: if type(obj) is type(1)
• Yes: if isinstance(obj, int)