十年老程序员整理的Python规范,提高你代码的可读性( 二 )

十年老程序员整理的Python规范,提高你代码的可读性

1.通过括号来将过长的运算进行封装.

2.通过换行符来实现.

文档规范

import 尽量放在开头.不要使用 import 一次导入多个模块.from module import func 这样的语句,请确保 func 在本文件中不会出现命名冲突。或者通过 from module import func as new_func 来进行重命名,从而避免冲突。注释规范

行注释并不是很推荐的方式。

文档描述

docstring 的写法,它是用三个双引号开始、三个双引号结尾。我们首先用一句话简单说明这个函数做什么,然后跟一段话来详细解释;再往后是参数列表、参数格式、返回值格式。

十年老程序员整理的Python规范,提高你代码的可读性

命名规范

推荐阅读