美文网首页
Python程序编写规范

Python程序编写规范

作者: 鹤子青云上 | 来源:发表于2022-05-24 16:12 被阅读0次

    程序的编码风格是一个人编写程序时表现出来的特点、习惯逻辑思路等。我们在程序开发时要重视其编写规范,程序不仅应该能够在机器上正确执行,还应便于调试、维护及阅读。

    PEP8是一份关于Python编码规范指南,遵守该规范能够帮助Python开发者编写出优雅的代码,提高代码可读性。下面举例说明一些编程规范。

    1.代码布局

    (1)缩进。标准Python风格中每个缩进级别使用4个空格,不推荐使用Tab,禁止混用空格与Tab。

    (2)行的最大长度。每行最大长度79,换行可以使用反斜杠,但建议使用圆括号。

    (3)空白行。顶层函数和定义的类之间空两行,类中的方法定义之间空一行;函数内逻辑无关的代码段之间空一行,其他地方尽量不要空行。

    2.空格的使用

    (1)右括号前不要加空格。

    (2)逗号、冒号、分号前不要加空格。

    (3)函数的左括号前不要加空格,如fun(1)。

    (4)序列的左括号前不要加空格,如list[2]。

    (5)操作符左右各加一个空格,如a+b=c。

    (6)不要将多条语句写在同一行。

    (7)if、for、while语句中,即使执行语句只有一句,也必须另起一行。

    3.代码注释

    (1)块注释。块注释跟随被注释的代码,缩进至与代码相同的级别。块注释使用“#”开头。

    (2)行内注释。行内注释是与代码语句同行的注释。行内注释与代码至少由两个空格分隔,注释以“#”开头。

    (3)文档字符串。文档字符串指的是为所有公共模块、函数、类以及方法编写的文档说明。文档字符串使用三引号包裹。

    4.命名规范

    (1)不要使用字母“I”(L的小写)、“0”(大写0)、“I”(大写I)作为单字符变量名。

    (2)模块名、包名应简短且全为小写。

    (3)函数名应该小写,如果想提高可读性,可以用下画线分隔小写单词。

    (4)类名首字母一般使用大写。

    (5)常量通常采用全大写命名。

    相关文章

      网友评论

          本文标题:Python程序编写规范

          本文链接:https://www.haomeiwen.com/subject/csnjprtx.html