python中有哪些编码规范
导读:本文共3404.5字符,通常情况下阅读需要11分钟。同时您也可以点击右侧朗读,来听本文内容。按键盘←(左) →(右) 方向键可以翻页。
摘要: 缩进每一级缩进4个空格。续行应该与包裹元素对齐,要么使用圆括号,方括号,花括号内的隐式行连接来垂直对齐,要么使用挂行缩进对齐。当使用挂行缩进对齐时,应该考虑到第一行不应该有参数,以及使用缩进以区分自己是续行。对齐缩进(左右括号对齐)deflong_function_name(var_one,var_two,var_three,var_four):print(... ...
目录
(为您整理了一些要点),点击可以直达。每一级缩进4个空格。
续行应该与包裹元素对齐,要么使用圆括号,方括号,花括号内的隐式行连接来垂直对齐,要么使用挂行缩进对齐。当使用挂行缩进对齐时,应该考虑到第一行不应该有参数,以及使用缩进以区分自己是续行。
对齐缩进(左右括号对齐)
悬挂缩进
层级缩进
所有行限制的最大字符数为79
没有结构化限制的大块文本(文档字符或者注释),每行的最大字符数限制在72。
顶层函数和类定义,前后用两个空行隔开。
类里面方法定义用一个空行隔开。
变量命名
永远不要使用字母I (小写的L), O (大写的O), I (大写的I)作为单字符的变量名。
在有些字体里面,这些字符无法与数字0和1区分。如果想用I, 可使用L代替。
函数命名
函数名应该小写,如果想提高可读性可以用下划线分隔。
大小写混合仅在为了兼容原来主要以大小写混合风格的情况下使用,保持向后兼容。
类命名
类名一般使用首字母大写的约定。
在接口被文档化并且主要被用于调用的情况下,可以使用函数的命名风格代替。
注意:对于内置的变量命名有一个单独的约定:大部分内置变量是单个单词(或者两个单词连接在一起),首字母大写的命名法只用于异常名或者内部的常量。
类里面函数和方法参数
始终要将self作为实例方法的第一个参数。
始终要将cls作为类方法的第一个参数。
如果函数的参数名和已有关键字冲突,在最后加大意下划线比缩写或者随意拼写更好。因此class_比clss更好。
单引号和双引号字符串是相同的。PEP不会为这个给出建议。选择一条规则并坚持使用下去。当一个字符串中包含单引号或者双引号字符串的时候,使用和最外层不同的符号来避免使用反斜杠,从而提高可读性。
模块和包导入规范
命名规范 模块名称要短,使用小写,并避免使用特殊符号, 比如点和问号
因此请尽量保持模块名简单,以无需分开单词最佳(不推荐在两个单词之间使用下划线)
模块导入建议
__all__变量
如果模块中存在全局变量__all__, 那么通过__all__ from xxx import *导入时也只会导入__all__中指定的方法和变量,没有的话默认全部导入。
任意包含__init__.py文件的目录都被认为是一个python包。
因为导入包时会首先执行__init__.py文件
包中__init__.py文件中__all__变量的作用
init.py文件中存在全局变量__all__, 通过from xxx import *导入时也只会导入__all__中指定的方法和变量,没有的话默认全部导入。
块注释
块注释通常适用于跟随它们的某些(或全部)代码,并缩进到与代码相同的级别。块注释的每一行开头使用一个#和一个空格(除非块注释内部缩进文本)。
块注释内部的段落通常只有一个#的空行分隔。
行内注释
有节制地使用行内注释
行内注释是与代码语句同行的注释。行内注释和代码至少要有两个空格分隔。注释由#和一个空格开始。
文档注释
要为所有的公共模块,函数,类和方法编写文档说明。
非公共的方法没有必要,但是应该有一个描述方法具体作用的注释。这个注释应该在def那一行之后。
PEP257描述了写出好的文档注释的相关约定。特别需要注意的是:多行文档注释使用的结尾三引号应该是自成一行,例如:
python中有哪些编码规范的详细内容,希望对您有所帮助,信息来源于网络。