Python程序编写规范【编程约定】

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

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）常量通常采用全大写命名。