python编程标准_python编程规范

优美的程序不仅仅靠语言约束，更需要良好的编程规范。

缩进：每一级缩进使用4空格

空格：

逗号、冒号、分号、右括号前不准加空格

操作符左右默认加空格，不能为了对齐加空格

换行、行长度：

每行不超过80字符

避免使用反斜杠连接行，推荐利用圆括号、中括号、花括号中的行隐式连接。

例子：

避免

if(a == 1 or a == 2 or\

a == 3 or a == 4 or a == 5):

print(1)

推荐

if(a == 1 or a == 2 or

a == 3 or a == 4 or a == 5):

print(1)

空行：顶级定义之间空两行，方法定义之间空一行

import导入：尽量分开导入

推荐

import os

import sys

不推荐

import os,sys

导入顺序：

标准库->相关第三方库->本地应用/库特定导入 每一组导入之间加入空行

注释#

注释要和代码保持一致

注释应该具有完整句子，尽量用英文书写

注释块''' '''

块注释内部的段落通过只有一个#的空行分隔

行内注释#

尽量避免行内注释

应该与代码同行注释，注释和代码之间至少空两格

命名规范

名称中尽量避免出现‘l’（小写的L），‘O’（大写的O），或者‘I’（大写的I）作为单字符变量名

类名采用CapWords形式，模块内部类采用_CapWords方式

函数名小写，下划线分割 fun_a(self)

其他建议

尽可能实验is 代替==，使用is not代替!=

异常捕获try包含的内容尽量少

字符串不要以空格收尾