Python 编程规范

Python 编程规范

分号

    不要使用分号

    不要使用分号将两个语句放在一行

行长度

    每行不要超过100字符长度

    不要使用反斜杠(\)连接行

    Python会将圆括号/中括号/大括号中的行隐式的连接起来,可以利用这个特点来将行连接起来

    注: 如果注释中URL长度过长可以不用隐式连接,import过长也可以不用隐式链接

括号

    不要在返回语句或条件语句中使用括号

缩进

    使用4个空格来进行代码缩进,切记不要使用tab

    不同编辑器之间tab默认空格数量不同

空行

    顶级定义之间空两行, 比如函数或者类定义.

    方法定义, 类定义与第一个方法之间空一行.

空格

    括号内不要有空格.

    不要在逗号, 分号, 冒号前面加空格, 但应该在它们后面加(除了在行尾).

    参数列表, 索引或切片的左括号前不应加空格.

    在二元操作符两边都加上一个空格(赋值、比较、布尔等),若不能保持一个空格也要保证空格数量一致

    当’=’用于指示关键字参数或默认参数值时, 不要在其两侧使用空格.

    不要用空格来垂直对齐多行间的标记

开头

    大部分.py文件不必以#!作为文件的开始. 根据 PEP-394 , 程序的main文件应该以 #!/usr/bin/python2或者 #!/usr/bin/python3开始.

注释

    文档字符串的惯例是使用三重双引号"""

    为了提高可读性, 注释应该至少离开代码2个空格.

类

    如果一个类不继承自其它类, 就显式的从object继承. 嵌套类也一样.

字符串

    为多行字符串使用三重双引号"""而非三重单引号'''

文件和socket

    在文件和sockets结束时, 显式的关闭它

    推荐使用 "with"语句 以管理文件

导入格式

    每个导入应该独占一行

    导入总应该放在文件顶部, 位于模块注释和文档字符串之后, 模块全局变量和常量之前. 导入应该按照从最通用到最不通用的顺序分组

语句

    通常每个语句应该独占一行

命名规则

 
                      

Python之父Guido推荐的规范

Main

    在执行主程序前总是检查 if __name__ =='__main__' , 这样当模块被导入时主程序就不会被执行.

--------------------------------------------------------------------------------------
版权所有,转载时必须以链接方式注明源地址,否则追究法律责任!

QQ    :   413844436
Email  :   softomg@163.com
Blog   :   http://blog.youkuaiyun.com/softomg