Python基础-PEP8: Python代码风格指南

PEP8: 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导包位于文件顶部, 在模块注释、文档字符串之后, 全局变量、常量之前. 导入按照以下顺序分组:
  

            4.2.1标准库导入
                   4.2.2相关第三方导入
                   4.2.3本地应用/库导入
                   4.2.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 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，方法名和实例变量使用下划线分割的小写单词, 以提高可读性

最后修改:2021-06-30 22:02:12