Pyhton3编程规范

Posted 2020-08-20

1. 行末尾不能加分号

2. 行长度

    每行不超过80个字符

    以下情况除外：

    长的导入模块语句

    注释里的URL

    不要使用反斜杠连接行。

    Python会将 圆括号, 中括号和花括号中的行隐式的连接起来 , 你可以利用这个特点. 如果需要, 你可以在表达式外围增加一对额外的圆括号。

    举例1：

    x=(‘你好好哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈‘

        ‘哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈‘)

    举例2：

    foo_bar(self, width, height, color=‘black‘, design=None, x=‘foo‘,
             emphasis=None, highlight=0)

     if (width == 0 and height == 0 and
         color == ‘red‘ and emphasis == ‘strong‘):

举例3：

在注释中，如果必要，将长的URL放在一行上。

Yes:  # See details at
      # http://www.example.com/us/developer/documentation/api/content/v2.0/csv_file_name_extension_full_specification.html

No:  # See details at
     # http://www.example.com/us/developer/documentation/api/content/     # v2.0/csv_file_name_extension_full_specification.html

3.勿滥用括号

No:  if (x):
         bar()
     if not(x):
         bar()
     return (foo)
 Yes: if x:
      if not x:

4.缩进

用4个空格来缩进代码

绝对不要用tab, 也不要tab和空格混用. 对于行连接的情况, 你应该要么垂直对齐换行的元素(见 :ref:`行长度 <line_length>` 部分的示例), 或者使用4空格的悬挂式缩进(这时第一行不应该有参数

5.空行

顶级定义之间空两行, 方法定义之间空一行

顶级定义之间空两行, 比如函数或者类定义. 方法定义, 类定义与第一个方法之间, 都应该空一行. 函数或方法中, 某些地方要是你觉得合适, 就空一行.

6.空格

按照标准的排版规范来使用标点两边的空格

括号内不要有空格.

按照标准的排版规范来使用标点两边的空格

Yes: spam(ham[1], {eggs: 2}, [])

6.多行语句

Python语句中一般以新行作为为语句的结束符。

但是我们可以使用斜杠（ \）将一行的语句分为多行显示，如下所示：

total = item_one +         item_two +         item_three

语句中包含[], {} 或 () 括号就不需要使用多行连接符。如下实例：

days = [‘Monday‘, ‘Tuesday‘, ‘Wednesday‘,
        ‘Thursday‘, ‘Friday‘]