python代码风格

PEP8提供了Python代码的编写约定,本节知识点旨在提高代码的可读性, 并使其在各种Python代码中编写风格保持一致。

1,缩进使用4个空格, 空格是首选的缩进方式. Python3 不允许混合使用制表符和空格来缩进。

2,每一行最大长度限制在79个字符以内。

3,顶层函数、类的定义, 前后使用两个空行隔开。

4,import 导入

     4.1导入建议在不同的行, 例如:

import os
import sys
# 不建议如下导包
import os, sys
# 但是可以如下:
from subprocess import Popen, PIPE

   4.2导包位于文件顶部, 在模块注释、文档字符串之后, 全局变量、常量之前. 导入按照以下顺序分组:
            1标准库导入    

     2相关第三方导入

                 3本地应用/库导入
                 4在每一组导入之间加入空行

5,Python 中定义字符串使用双引号、单引号是相同的, 尽量保持使用同一方式定义字符串. 当一个字符串包含单引号或者双引号时, 在最外层使用不同的符号来避免使用反斜杠转义, 从而提高可读性。

6,表达式和语句中的空格:

     6.1避免在小括号、方括号、花括号后跟空格.
          6.2避免在逗号、分好、冒号之前添加空格.
          6.3冒号在切片中就像二元运算符, 两边要有相同数量的空格. 如果某个切片参数省略, 空格也省略.
          6.4避免为了和另外一个赋值语句对齐, 在赋值运算符附加多个空格.
          6.5避免在表达式尾部添加空格, 因为尾部空格通常看不见, 会产生混乱.
          6.6总是在二元运算符两边加一个空格, 赋值(=),增量赋值(+=,-=),比较(==,<,>,!=,<>,<=,>=,in,not,in,is,is not),布尔(and, or, not

7,避免将小的代码块和 if/for/while 放在同一行, 要避免代码行太长。

if foo == 'blah': do_blah_thing()
for in lst: total += x
while t < 10: t = delay()


8,永远不要使用字母 'l'(小写的L), 'O'(大写的O), 或者 'I'(大写的I) 作为单字符变量名. 在有些字体里, 这些字符无法和数字0和1区分, 如果想用 'l', 用 'L' 代替。

9,类名一般使用首字母大写的约定。

10,函数名应该小写, 如果想提高可读性可以用下划线分隔

11,如果函数的参数名和已有的关键词冲突, 在最后加单一下划线比缩写或随意拼写更好. 因此 class_ 比 clss 更好.(也许最好用同义词来避免这种冲突)

12,方法名和实例变量使用下划线分割的小写单词, 以提高可读性

posted @ 2021-06-18 11:41  hesperid  阅读(126)  评论(0编辑  收藏  举报