Python pep8原则
Guido的主要见解之一是代码读取的次数比写入次数多得多。这里提供的准则旨在提高代码的可读性并使其在各种python代码中保持一致。
代码布局 缩进:四个空格的缩进(编辑器都可以完成此功能),不要使用tab,更不能混合使用tab和空格
缩进 每个缩进级别使用4个空格。
连续行应使用python的隐式行连接括号,小括号和大括号,或者使用悬挂缩进来垂直对齐包装元素。
悬挂缩进不一定是4个空格
if语句跨行时,两个字符关键字(比如if)加上一个空格,再加上左括号构成了很好的缩进。后续行暂时没有规定,至少有如下三种格式,建议使用第三种。 行宽
每行最大长度79,换行可以使用反斜杠,最好使用圆括号。换行点要在操作符的后边敲回车。文本长块,比如文档字符串或注释,行长度应限制为72个字符。
空行
1、类和top-level函数定义之间空两行 2、类中方法定义之间空一行 3、函数内逻辑无关段落之间空一行 4、其他地方尽量不要再空行
源文件编码
模块导入
1、导入顺序进行分组: 2、标准库导入 3、相关的第三方进口 4、本地应用程序/库特定的导入应该在每组的导入之间留出空行。
表达式和语句中的空格
1、在以下情况下避免无关的空白:括号或大括号内 2、尾随逗号和后面的右括号之间 3、在逗号,分号或冒号前面 4、在函数的调用,小括号之前 5、在一个切片中,冒号的作用就像一个二元运算符,并且两边应该有相同的数量;在扩展切片中,两个冒号必须具有相同量的间距。例外:当省略切片参数时,空格被省略 6、在一个赋值(或其他)运算符周围的多个空间将其与另一个对齐 8、关键字参数和默认值参数的前后不要加空格 7、二元运算符两个放置一个空格;涉及=、复合操作符(+=,-=等)、比较(==,<,>,!=,<>,<=,>=,in,not in,is,is not)、布尔(and,or,not).优先级高的运算符或操作符的前后不建议有空格。 注释 命名规范
|