【python小记】---PE8规范简述

发布时间 2023-11-27 21:01:29作者: Unfool


【补充点】PE8规范

> [Python注释补充之PE8规范](https://www.cnblogs.com/Jack-ze/p/17401922.html)

   【一】PEP 8规范

- PEP是Python Enhancement Proposal的缩写,代表Python增强提案。其中第8号增强提案(PEP 8)是关于Python代码风格的指南。

- 每个PEP都是一份技术文档,为Python社区提供指导,促使Python在不断进步。PEP 8着重于统一Python代码的风格,使其更易读、易维护,适用于多人协作开发的场景。


  【二】PEP 8规范的内容

   【1】空格的使用

- 使用空格表示缩进,不使用制表符(Tab)。
- 每一层缩进使用4个空格。
- 每行字符数不超过79个,多行表达式首行除外,其余行缩进4个空格。
- 函数和类定义之间使用两个空行分隔,类中方法之间使用一个空行分隔。

   【2】标识符的命名

- 变量、函数和属性使用小写字母,多个单词用下划线连接。
- 类中受保护的实例属性以一个下划线开头。
- 类中私有的实例属性以两个下划线开头。
- 类和异常的命名每个单词首字母大写。
- 模块级别的常量使用全大写字母,多个单词用下划线连接。
- 类的实例方法参数命名为self,类方法参数命名为cls。

    【3】表达式和语句

- 采用内联形式的否定词,如`if a is not b`。
- 避免使用检查长度的方式来判断字符串、列表是否为None或没有元素,应该使用`if not x`形式。
- 即使在if分支、for循环、except异常捕获中只有一行代码,也不要将代码和关键字写在一起,分开写更清晰。
- import语句总是放在文件开头。
- 引入模块时,`from math import sqrt`优于`import math`。
- 多个import语句分为三部分:Python标准模块、第三方模块和自定义模块,每部分按照字母表顺序排列。