Python编程规范与代码优化建议 PEP 8:Python编码风格指南
刚开始学习的时候,重点关注以下几点:
1)缩进
a.每级缩进使用4个空格;
b.空格是缩进方法的首选;
c. Python3不允许混用制表符和空格来缩进。
2)换行通常是在二元操作符之前换行
3)import导入语句
a.标准库导入;
b.相关的第三方导入;
c.特定的本地应用/库导入;
注意:
导入通常是单独一行。
导入常常位于文件顶部,在模块注释和字符串文档之后,在模块的全局变量和常量之前。
在每个导入组之间放一行空行。
4)字符串引号
a. Python中,单引号字符串和双引号字符串是一样的。
b. 建议选择一条规则并坚持下去。
c. 当一个字符串包含单引号字符或双引号字符时,使用另一种字符串引号来避免字符串中使用反斜杠。这能提高可读性。
5) 注释
a. 同代码相矛盾的注释比没有注释更差。当代码修改时,始终优先更新注释!
b.注释应该是完整的句子。如果注释是一个短语或句子,它的第一个单词的首字母应该大写,除非它是一个以小写字母开头的标识符(不更改标识符的情况下!)。
c. 如果注释很短,末尾可以不加句号。注释块通常由一个或多个段落组成,这些段落由完整的句子组成,并且每个句子都应该以句号结尾。在句尾的句号后边使用两个空格。写英语注释时,遵循断词和空格。