Python 代码风格

查看全部 Python3 基础教程

部分代码规范

大多数语言都有不同的书写(或简化、格式化)风格，有些语言比其他语言更有可读性。采用好的编码风格对提高代码可读性有很大帮助。

PEP 8 为 Python 代码风格提供了指南，其倡导代码要有可读性且养眼。此处列举了最重要的几点：

• 使用四个空格来缩进，而非 tabs 制表符。

  四个空格是小缩进(允许更大的嵌套深度)和大缩进(更容易阅读)之间的折中选择。而 tabs 会带来混淆，最好不用。

• 要换行使得每行不超过 79 个字符。

  这对使用小显示器的用户有帮助，在大显示器上还可以并排使用多个代码文件。

• 使用空行分隔函数和类，以及函数内部更大的代码块。

• 尽量把注释与代码写在同一行。

• 使用文档字符串。

• 在运算符周围和逗号后面使用空格，但不直接用在括号结构内部：a = f(1, 2) + g(3, 4)。

• 类和函数命名要有一致性，约定是对类使用 UpperCamelCase，对函数和方法使用 lowercase_with_underscores，始终使用 self 作为第一个方法参数的名称(有关类和方法的更多信息，请参见首次查看类)。

• 如果代码打算在国际环境中使用，则不要使用特殊的编码。Python 默认编码为 UTF-8，甚至用纯 ASCII 也能适用任何情况。

• 同样地，如果代码被说不同语言的人阅读或维护的机会很小，则不要在标识符中使用非 ASCII 字符。

参考资料

PEP 8 – Style Guide for Python Code
Python3 Tutorial – Intermezzo: Coding Style