PEP8代码风格

  1. 每层缩进使用4个空格。
  2. 续行要么与圆括号、中括号、花括号这样的被包裹元素保持垂直对齐,要么放在 Python 的隐线(注:应该是相对于def的内部块)内部,或者使用悬挂缩进。使用悬挂缩进的注意事项:第一行不能有参数,用进一步的缩进来把其他行区分开。(例如)
    # Aligned with opening delimiter.
    foo = long_function_name(var_one, var_two,
                             var_three, var_four)
    
    # More indentation included to distinguish this from the rest.
    def long_function_name(
            var_one, var_two, var_three,
            var_four):
        print(var_one)
    
    # Hanging indents should add a level.
    foo = long_function_name(
        var_one, var_two,
        var_three, var_four)
  3. 在多行结构中的右圆括号、右中括号、右大括号应该放在最后一行的第一个非空白字符的正下方,如下所示:
    my_list = [
        1, 2, 3,
        4, 5, 6,
        ]
    result = some_function_that_takes_arguments(
        'a', 'b', 'c',
        'd', 'e', 'f',
        )
    
  4. 限制每行的最大长度为79个字符。
  5. 顶级函数和类定义上下使用两个空行分隔。类内的方法定义使用一个空行分隔。

  6. 在核心 Python 发布版中的代码应该总是使用UTF-8编码(或者在 Python 2 中使用ASCII)。
  7. import不同的模块应该独立一行
  8. 空格的使用
      • 与后面的逗号、分号或冒号保持紧凑
      • 切片内的冒号就像二元操作符一样,任意一侧应该被等同对待(把它当做一个极低优先级的操作)。
      • 与括号保持紧凑(小括号、中括号、大括号)
      • 函数名与其后参数列表的左括号应该保持紧凑
      • 与切片或索引的左括号保持紧凑
      • 在赋值操作符(或其它)的两侧保持多余一个的空格
      • 不要在关键值参数或默认值参数的等号两边加入空格
      • 带注释的函数定义中的等号两侧要各插入空格。此外,在冒号后用一个单独的空格,也要在表明函数返回值类型的->左右各插入一个空格。
      • 打消使用复合语句(多条语句在同一行)的念头。

猜你喜欢

转载自www.cnblogs.com/moxianghuibi/p/11368649.html