python编写规范-Python代码编写规范

Python代码编写规范

编码:

a) 如无特殊情况,文件一律使用UTF-8编码

b) 如无需特殊情况,文件头部必须加入#-*-coding:utf-8-*-

缩进

a) 统一使用4个空格进行缩进

引号

a) 自然语言使用双引号”….”,正则表达式使用原生的双引号r””

b) 机器标识使用单引号’’

c) 文档字符串(docstring)使用三个双引号”””…”””

空行

a) 模块级函数和类定义之间空两行

b) 类成员函数之间空一行

import语句

a) import语句应按照顺序排列,每组之间用一个空行分隔

二元运算符

a) 二元运算符两边各空一格, = -

函数的参数列表

a) 函数的参数列表中’,’逗号之后要有空格

b) 函数的参数列表中,默认值等号两边不要添加空格

c) 左括号之后,右括号之前不要加多余的空格

d) 字典对象的左括号之前不要多余的空格

换行

a) 第二行缩进到括号的起始处

b) 第二行缩进4个空格,适用于起始括号就换行的情形

docstring

a) 所有的公共模块,函数,类,方法,都应该写docstring,私有方法不一定需要,但是应该在def后提供一个块注释来说明”””…”””

注释

a) 有意义的注释 list #list

b) 比较重要的注释段,使用多个等号隔开,可以更加醒目,突出重要性

命名规范

a) 模块名称尽量使用小写命名,首字母保持小写,尽量不要用下划线(除非多个单词,且数量不多的情况

b) 类名使用驼峰(CamelCase)命名风格,首字母大写

c) 函数命名一律小写,如有多个单词,用下划线隔开

d) 变量名尽量小写,如有多个单词,用下划线隔开

e) 常量采用全大写,如有多个单词,使用下划线隔开