制定个人代码规范

最新推荐文章于 2024-10-02 10:53:34 发布

BigheEad

最新推荐文章于 2024-10-02 10:53:34 发布

阅读量95

点赞数

文章标签： python

本文链接：https://blog.csdn.net/L20011002/article/details/120388803

版权

1、代码布局

1.1缩进换行

每个缩进级别使用四个空格

当使用悬挂缩进时：第一行不应该有任何参数，进一步缩进来区分，如

def long_function_name(
        var_one, var_two, var_three,
        var_four):
    print(var_one)

最后一行的括号对齐到列表最后一列的第一个非空或第一个字符下，如
```
my_list = [
    1, 2, 3,
    4, 5, 6,
    ]

my_list = [
    1, 2, 3,
    4, 5, 6,
]
```
在二进制运算符后换行
import应该在单独的行上

1.2 最大行长度

所有行限制最多有79个字符（文档字符串、注释限制为72字符）
多个with语句可以通过反斜杠来延续

1.3字符串引用

当字符串包含单引号或双引号时，使用另一个引号以避免字符串出现反斜杠

2、表达式和语句的空白

2.1在括号里

spam(ham[1], {eggs: 2})
foo = (0,)

2.2在逗号、分号或冒号之前

if x == 4: print x, y; x, y = y, x

2.3在切片中

ham[1:9], ham[1:9:3], ham[:9:3], ham[1::3], ham[1:9:]
ham[lower:upper], ham[lower:upper:], ham[lower::step]
ham[lower+offset : upper+offset]
ham[: upper_fn(x) : step_fn(x)], ham[:: step_fn(x)]
ham[lower + offset : upper + offset]

2.4运算操作中

在优先级最低的操作符周围添加空格
二进制操作符的两边总是有相同数量的空格
```
x = x*2 - 1
hypot2 = x*x + y*y
c = (a+b) * (a-b)
```

2.5在函数中

出现->箭头，周围有空格

指示关键字参数或参数默认值时，不要在=周围使用空格

def munge(input: AnyStr): ...
def munge() -> PosInt: ...
def munge(input: AnyStr, sep: AnyStr = None, limit=1000): ...

def complex(real, imag=0.0):
    return magic(r=real, i=imag)