PEP8: Python代码风格指南

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

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

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

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

  4. import 导入

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

      import os
      import sys
      # 不建议如下导包
      import os, sys
      # 但是可以如下:
      from subprocess import Popen, PIPE
      
    2. 导包位于文件顶部, 在模块注释、文档字符串之后, 全局变量、常量之前. 导入按照以下顺序分组:

      1. 标准库导入
      2. 相关第三方导入
      3. 本地应用/库导入
      4. 在每一组导入之间加入空行
  5. Python 中定义字符串使用双引号、单引号是相同的, 尽量保持使用同一方式定义字符串. 当一个字符串包含单引号或者双引号时, 在最外层使用不同的符号来避免使用反斜杠转义, 从而提高可读性.

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

    1. 避免在小括号、方括号、花括号前跟空格.
    2. 避免在逗号、分好、冒号之前添加空格.
    3. 冒号在切片中就像二元运算符, 两边要有相同数量的空格. 如果某个切片参数省略, 空格也省略.
    4. 避免为了和另外一个赋值语句对齐, 在赋值运算符附加多个空格.
    5. 避免在表达式尾部添加空格, 因为尾部空格通常看不见, 会产生混乱.
    6. 总是在二元运算符两边加一个空格, 赋值(=),增量赋值(+=,-=),比较(==,<,>,!=,<>,<=,>=,in,not,in,is,is not),布尔(and, or, not
  7. 避免将小的代码块和 if/for/while 放在同一行, 要避免代码行太长.

    if foo == 'blah': do_blah_thing()
    for x 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. 方法名和实例变量使用下划线分割的小写单词, 以提高可读性.

更多规范点击查看官网