python PEP8 记录

版权声明：本文为博主原创文章，未经博主允许不得转载。python版本为python3，实例都是经过实际验证。 https://cloud.tencent.com/developer/article/1437413

好的编程风格不仅可以提高工作效率，同时也是一个coder本身素养的体现。正对于python语言的编程风格，PEP8已经给出了很好的指导，按照PEP8写python，绝对是最佳的风格。

pep8英文原版地址：https://www.python.org/dev/peps/pep-0008/

1. 代码布局

1.1 缩进一律采用4个空格

缩进一律采用4个空格，拒绝TAB（制表符），更不能将空格和TAB混用。

1.2 换行

换行应该与上一行的同级元素对齐，一般采用两种形式： 采用圆括号(),方括号[], 或者花括号{}的隐式行连接来垂直对齐；或者是使用悬挂缩进对齐，悬挂缩进的第一行不应该有参数。

# 垂直对齐
foo = long_func_name(var_one, var_two,
					 var_three,var_four):
		
# 悬挂缩进
foo = long_func_name(
		var_one, var_two,
		var_three, var_four):					

NOTE: 悬挂缩进第一行不能有参数，例如：

# 悬挂缩进，错误的示范
foo = long_func_name(var_one, var_two,
		var_three, var_four):	

1.3 行最大长度为79个字符

不管什么情况，每行不能超过79个字符，而对于没有结构化限制的大块文本（包括文档字符和注释），每行字数不超过72个。

1.4 空行

顶层行数和类的定义，前后需要两个空格。

类中的方法之间用一个空格。

1.5 文件编码

python3.0以后全部采用utf-8编码，python3.0以前符合latin-1（ISO/IEC 8859-1）编码。

python2和python3在编码上有不同，所以存在很多不兼容的情况，例如pickle。

1.6 import

(1) 每个模块分开导入，同一个模块的不同子模块在一行导入

# 正确导入方式
# os和sys是不同的模块
import os
import sys

# image 和 util 是nilearn中的不同子模块
from nilearn import image,util

# 错误的导入方式
import os, sys

（2）import 通常放在代码文件的顶部，可以遵循以下3个顺序： 标准库，第三方库，本项目中的自有模块,每一组之间用空格分开。

# python标准库
import os
import sys

# 第三方库
import numpy as np

# 本项目中的自有模块
import project_module

（3）最好是采用绝对引用，明确的相对引用也可以接受

（4）尽量不要用通配符引用，例如：

# 尽量避免这种引用方式
from numpy import *

2. 引号

python中单引号（’）和双引号(")完全一样。

3. 空格

3.1 括号，方括号，花括号前后不加空格，但等号与括号之间加空格（函数参数除外）。

# 正确示例
foo = func(var_1=[1,2], var_2={'age': 5})
para_1 = (1,2,4)

# 错误的示例
foo = func ( var_1 = [ 1, 2 ] )

3.2 逗号后面如果是括号等则不加空格

# 正确示范
a = (0,)

# 错误的示范
a = (0, )

3.3 逗号、分号、冒号的前面不加空格

# 正确的示范
if x == 4:
	print(y, x)
# 错误的示范
if x == 4:
	print(y , x )

3.4 分号作为切片时，前后都不要空格

4. 注释

4.1 行注释用 # ，且#与注释文本之间用空格隔开

4.2 文本注释用3双引号对，三个双引号对之间的任何内容都是注释

# 这是行注释
x = 12     # 这也是行注释

"""
这是文档注释
"""

5. 命名规范

在命名上存在多个风格，只是建议。

5.1 变量名和函数名采用 小写+下划线模式

var_one = 1;
def long_func_name():
	pass

5.2 类定义采用大写字母开头

class ClassOne():

	pass

5.3 命名约定

（1） 前后双下划线是python私有成员，对外部不可见，不能被导入

__name__ 等

（2）单下划线起始的函数为内部函数，不应该对外部可见

def _func_xxx():
	pass

5.4 异常名

所有的异常属于类，所以遵循类的命名风格（大写字母开始），并在异常名后面加上Error

ValueError

5.5 常量用大写字母

MAX_STEPS = 10000

6. 表达语句

6.1 用is…not… 而不是 not… is …

# yes
if foo is not None:
	print(foo)

# no
if not foo is None:
	print(foo)

6.2 不要将lambda语句直接赋值给变量

# yes
def func(x):
	return(2*x)

# no
f = lambda x: 2*x

6.3 关于try…except…的用法