一篇文章看懂Python代码的编写规范

Python代码的书写规范

1. 一致性的建议

打破一条既定规则的两个好理由

应用此规则会导致代码可读性差，即使对于习惯根据此规则阅读代码的人也是如此

打破与周围代码一致性的规则（可能是出于历史原因）

2. 代码的布局

缩进

4个空格

代码行

行长度 : 79字符

推荐长度 : 72字符

分割方式 : "" , "()" , "{}"

空行

两行空行分割顶层函数和类的定义

一行空行分割方法或函数

额外空行分割相关函数群

类定义与第一个方法定义需要一行空行

编码

万年 "UTF-8"

导入

先导入标准模块，再从...导入第三方模块（绝对路径），最后从...导入自建模块

每组导入空一行,一行导入一个包[模块,类等]

空格

紧贴各类括号

紧贴逗号,分号,冒号前

紧贴函数调用参数列表前开放式括号

紧贴再索引或切片括号

二元运算符或运算符或逻辑等的每一侧都有一个空格。

默认参数或关键参数"="不留空格

3. 注释

注释块

与相应代码有着相同缩进

行内注释

与代码被注释代码同行,以"#"+" "开头

文档注释

结尾处 """ 单独成行

版本注记

模块docstring之后，所有代码之前，上下空行分隔

4. 命名

约定

模块名 : 不含下划线 ; 小写 ; 剪短

类名,异常名 : 首字母大写单词串

method, function : 首字母小写首字母大写单词字符串

属性,实例,变量 : 小写字母串

继承

私有 : 双下划线开头

非公有 : 单下划线开头

命名冲突

不要降低可读性，如果可以改变它，你不能只在最后添加一个下划线或数字

5. 设计建议

使用"is"或"is not"进行对"None"的单值比较

使用字符串方法代替字符串模块

使用startswith()和endswith()检查前后缀而不是使用切片

使用isinstance()判断对象是否是字符串而不是使用type()

判断空序列或字典不要使用len()

书写字符串文字不要依赖有意义的后置空格

不要用"=="比较布尔值