Python 编码规范
官网规范:https://www.python.org/dev/peps/pep-0008/
1、不在同一句import中引用多个库
# 正确姿势: import os import sys # 错误姿势 import os,sys # 未被使用的库就不用引用了
2、代码长度约束
一行列数:PEP8 规定最大为79列,如果拼接url很容易超限
一个函数:不可以超过30行;直观来讲就是完整显示一个函数一个屏幕就够了,不需要上下拖动
一个类:不要超过200行代码,不要超过10个方法
一个模块:不要超过500行
3、常见格式问题
1)W292 no newline at end of file 处理:在代码末尾加一行回车就行 2)E302 expected 2 blank lines,found 1 处理:需要再补一个空白行(函数之间需要最少2个空白行,方便查阅、区分) 3)E231 missing whitespace after ‘,’ 处理:原因简单来说还是要方便查看,即逗号后“,”需要补空格 示例: print("%s %s %s %s" %(A,B,C,D))print("%s %s %s %s" % (A, B, C, D)) 也许在这里并不能非常明显看出来,但是当代码多的时候,你会发现适当的空格会显得代码容易观看 4)E225 missing whitespace around operator 处理:主要原因其实跟上面的问题三差不多,主要目的都是为了查看方便 5)W291 trailing whitespace 处理:字面意思,函数、或者代码段终止处出现了多余的空格 举例 return kw (这里多了几个空格,错误)return kw
6)函数间隔
两个函数体之间,间隔两个空行
7)其他
1 typo found # 1个错误被发现
1 weak warning found # 1个弱警告
4、空格
空格在 Python 代码中是有意义的,因为 Python 的语法依赖于缩进,在行首的空格称为前导空格。在这一节不讨论前导空格相关的内容,只讨论非前导空格。非前导空格在 Python 代码中没有意义,但适当地加入非前导空格可以增进代码的可读性。
# 在二元算术、逻辑运算符前后加空格:如 a = b + c; # 在一元前缀运算符后不加空格,如 if !flg: pass; # “:”用在行尾时前后皆不加空格,如分枝、循环、函数和类定义语言;用在非行尾时两端加空格,如:dict 对象的定义 d = {'key' : 'value'}
# 括号(含圆括号、方括号和花括号)前后不加空格,如: do_something(arg1, arg2) 而不是 do_something( arg1, arg2 )
# 不要在逗号、分号、冒号前面加空格,但应该在它们后面加(除了在行尾)
# 不要用空格来垂直对齐多行间的标记,因为这会成为维护的负担(适用于:,#,=等)
5、空行
适当的空行有利于增加代码的可读性,加空行可以参考如下几个准则:
1) 在类、函数的定义间加空行;
2) 在 import 不同种类的模块间加空行;
3) 在函数中的逻辑段落间加空行,即把相关的代码紧凑写在一起,作为一个逻辑段落,段落间以空行分隔;
出处:http://www.cnblogs.com/madsnotes/
声明:本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接。