首页 / 知识

pythonPython代码的书写规范

2023-11-12 13:00:00

python代码的书写规范

1.一致性的建议

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

当应用这个规则将导致代码可读性下降,即使对于某人来说他已经习惯于按照这条规则来阅读代码了

为了和周围的代码保持一致而打破规则(也许是历史原因)

2.代码的布局

缩进

4个空格

代码行

行长度:79字符

推荐长度:72字符

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

空行

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

一行空行分割方法或函数

额外空行分割相关函数群

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

编码

万年"UTF-8"

导入

先import标准模块,再from...import第三方模块(绝对路径),最后from...import自建模块

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

空格

紧贴各类括号

紧贴逗号,分号,冒号前

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

紧贴再索引或切片括号

二元操作符或运算符或逻辑等两边各留一个空格

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

3.注释

注释块

与相应代码有着相同缩进

行内注释

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

文档注释

结尾处"""单独成行

版本注记

模块文档字符串之后,所有代码之前,上下空行分割

4.命名

约定

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

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

方法,函数:第一个字母小写的首字母大写单词串

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

继承

私有:双下划线开头

非公有:单下划线开头

命名冲突

不降低可读性,能改就改,不能就在末尾加单个下划线或者数字

5.设计建议

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

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

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

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

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

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

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

以上内容为大家介绍了python培训之Python代码的书写规范，希望对大家有所帮助，如果想要了解更多Python相关知识，请关注我们

培训代码设计数字标准

最新内容

相关内容

热门文章

推荐文章

标签云

猜你喜欢