Python 语言规范

Lint

使用 pylint 工具

pylint 是一个在 Python 源代码中查找 bug 的工具。

可以使用 pylint --list-msgs 来获取 pylint 警告列表。

使用 pylink --help-msg=C6409 获取关于特定消息的更多信息.

导入

仅对包和模块进行导入，而不单独导入函数或者类。

使用 from x import y as z 当模块太长。

包

使用模块的全路径名来导入每个模块。

异常

ValueError 指示一个程序错误。

assert 保证内部的正确性。

raise 语句，指示意外情况。

减少 try/except 块中的代码量。

使用 finally 子句来执行那些无论 try 块中有没有异常都应该被执行的代码。

全局变量

避免全局变量。

鼓励使用模块级的常量如 MAX_HOLY_HANDGRENADE_COUT = 3，命名全用大写且用 _ 分隔。

条件表达式

适用于单行函数。

又名三元运算符，是对于 if 语句的一种更简短的句法规则:

x = 1 if cond else 2