002.[python学习]python编码规范pep8学习——PEP8第一部分代码布局

     关于PEP8的详细说明可以参考官方原文：http://legacy.python.org/dev/peps/pep-0008/

    我参考官方文档及其他文章，摘出相关内容而得此文章，具体参考其他文章见文中最后参考资料处。

    当想要让自己所写的代码为更多人使用、交流学习时，不能写出只有机器认识的代码，而是对于人而言具有良好的可读性，此时就需要遵从一个公共的约束来规范自己的代码，那么《Style Guide for Python Code(PEP8)》是个很好的选择。

    首先PEP8中声明，有以下有理由忽略特定的规范：

    使用规范会降低代码可读性可不遵守；

    为了与其他代码保持一致可以不遵守规范(这种情况也许是历史原因)；

    因为代码早于引进规范并且没有必要理由去修改代码时，可以不遵守规范；

    代码需要兼容不支持代码风格建议的旧版本python时可不遵守。

1 代码布局

1.1    缩进

    每个缩进使用4个空格。

    python是靠缩进区分语句块的，语句块缩进不正确是无法通过语法检查的，这种是必须遵守的；

    跨行的语句需要遵守下面规范（英语不行，暂时就不翻译了，意会下）：

    Continuation lines should align wrapped elements either vertically using Python's implicit line joining inside parentheses, brackets and braces, or using a hanging indent [7]. When using a hanging indent the following should be considered; there should be no arguments on the first line and further indentation should be used to clearly distinguish itself as a continuation line.

    指的是续行应该和括起来的内容垂直对齐，或者使用叫hanging indent的格式。

    下面是符合规范的例子：

# 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)
# Hanging indents *may* be indented to other than 4 spaces.
foo = long_function_name(
  var_one, var_two,
  var_three, var_four)
# No extra indentation.
if (this_is_one_thing and
    that_is_another_thing):
    do_something()

# Add a comment, which will provide some distinction in editors
# supporting syntax highlighting.
if (this_is_one_thing and
    that_is_another_thing):
    # Since both conditions are true, we can frobnicate.
    do_something()

# Add some extra indentation on the conditional continuation line.
if (this_is_one_thing
        and that_is_another_thing):
    do_something()
my_list = [
    1, 2, 3,
    4, 5, 6,
    ]
result = some_function_that_takes_arguments(
    'a', 'b', 'c',
    'd', 'e', 'f',
    )
my_list = [
    1, 2, 3,
    4, 5, 6,
]
result = some_function_that_takes_arguments(
    'a', 'b', 'c',
    'd', 'e', 'f',
)

    下面是不符合规范的例子： 

# Arguments on first line forbidden when not using vertical alignment.
foo = long_function_name(var_one, var_two,
    var_three, var_four)

# Further indentation required as indentation is not distinguishable.
def long_function_name(
    var_one, var_two, var_three,
    var_four):
    print(var_one)

1.2     使用tab还是空格

    空格是更好的选择，尽量不要空格和tab混用。Python3中不允许混用的方式，python2中可以使用-t或-tt参数进行检查，混用时前者会产生警告，后者会产生错误。

1.3    单行最大长度79个字符

1.4    空白行：顶级函数和类定义之间使用两个空白行，类中函数定义之间使用单个空白行。

1.5    源文件编码格式：官方说python3用UTF-8，python2用ASCII，我觉得最好都用UTF-8。

1.6    模块导入应该单号导入一个，除from xxx import a, b这种外；导入语句应该放在源文件最前面，紧跟着模块注释和文档描述之后，在模块全局变量和常量之前。模块应按照顺序导入：最先导入系统标准模块，再导入相关第三方模块，最后导入本地自己编写的模块。