快捷搜索:  汽车  科技

python代码的注释有几种:Python的代码书写规范

python代码的注释有几种:Python的代码书写规范自然语言使用双引号,机器标示使用单引号,因此 代码里 多数应该使用 单引号。引号Python会将圆括号、中括号和花括号中的行隐式的连接起来,可以利用这个特点,在表达式外围增加一对额外的圆括号,不要使用反斜杠连接行。如果条件语句中条件过多,放在一行显得超长,可以使用圆括号来实现隐式连接,如下如果一个文本字符串放在一行显得超长,可以使用圆括号来实现隐式行连接,如下:

python代码的注释有几种:Python的代码书写规范(1)

代码书写规范

缩进

统一使用 4 个空格进行缩进,不要混合使用制表符和空格来缩进,也不要单独使用制表符Tab。对于行连接的情况,可以垂直对齐换行的元素。

python代码的注释有几种:Python的代码书写规范(2)


行宽

每行代码尽量不超过 80 个字符,在特殊情况下可以略微超过 80 ,如长的导入模块语句或注释里的URL。

Python会将圆括号、中括号和花括号中的行隐式的连接起来,可以利用这个特点,在表达式外围增加一对额外的圆括号,不要使用反斜杠连接行。

如果条件语句中条件过多,放在一行显得超长,可以使用圆括号来实现隐式连接,如下

python代码的注释有几种:Python的代码书写规范(3)

如果一个文本字符串放在一行显得超长,可以使用圆括号来实现隐式行连接,如下:

python代码的注释有几种:Python的代码书写规范(4)


引号

自然语言使用双引号,机器标示使用单引号,因此 代码里 多数应该使用 单引号。

  • 自然语言使用双引号

python代码的注释有几种:Python的代码书写规范(5)

  • 机器标识使用单引号

python代码的注释有几种:Python的代码书写规范(6)

  • 正则表达式使用双引号

python代码的注释有几种:Python的代码书写规范(7)

  • 文档字符串 (Docstring)使用三双引号

python代码的注释有几种:Python的代码书写规范(8)


空行

模块中类定义与函数之间空两行,类中各函数之间空一行,函数中可以使用空行分隔各逻辑代码块,使其更加清晰。

python代码的注释有几种:Python的代码书写规范(9)


模块导入

每个独立模块导入应该独占一行,导入代码应该放在文件顶部,置于模块说明、文档字符串之后,全局变量、常量之前,模块导入建议顺序建议参考以一下顺序,每组之间使用一个空行分隔:

  • 标准库导入
  • 第三方库导入
  • 自定义库导入

python代码的注释有几种:Python的代码书写规范(10)

同时,导入模块应尽量使用绝对导入。

python代码的注释有几种:Python的代码书写规范(11)


空格

在二元操作符两边都加上一个空格,如 =,== < > != <> <= >= in not in is is no,and or not。额外注意的是,当'='用于指示关键字参数或默认参数值时 不要在其两侧使用空格。

python代码的注释有几种:Python的代码书写规范(12)

函数的参数列表中“ ”之后要有空格,但左括号之后,右括号之前不要加多余的空格。

python代码的注释有几种:Python的代码书写规范(13)


python代码的注释有几种:Python的代码书写规范(14)

代码注释规范

块注释

“#”号后空一格,段落间需要用空行分开。

python代码的注释有几种:Python的代码书写规范(15)


行注释

行注释至少使用两个空格和语句分开。

python代码的注释有几种:Python的代码书写规范(16)


文档注释——文档字符串Docstring

作为文档的Docstring一般出现在模块、函数和类的头部,Python中可以通过对象的__doc__属性获取文档字符串。Python中模块、类、函数、方法、生成器,应尽量写文档字符串。外部不可见的私有方法可以不写,但应该在 def 后提供一个块注释说明。文档注释以 """ 开头和结尾 首行不换行 如有多行 末行必需换行。

python代码的注释有几种:Python的代码书写规范(17)

对函数的注释说明,建议参考如下注释规范,如下所示:

python代码的注释有几种:Python的代码书写规范(18)


python代码的注释有几种:Python的代码书写规范(19)

代码命名规范

模块命名

模块使用小写字母命名,首字母保持小写,尽量不要用下划线。

python代码的注释有几种:Python的代码书写规范(20)


类名命名

类名使用驼峰命名风格,首字母大写。

python代码的注释有几种:Python的代码书写规范(21)


函数命名

函数名全部采用小写字母,如有多个单词,用下划线隔开。

python代码的注释有几种:Python的代码书写规范(22)


变量命名

变量名尽量使用小写字母,常量采用全大写字母,如有多个单词,用下划线隔开。

python代码的注释有几种:Python的代码书写规范(23)

猜您喜欢: