Python 学习之旅,先来看看 Python 的代码规范,让自己先有个意识,而且在往后的学习中慢慢养成习惯,所以习惯特别特别重要,所以大家跟着小编往下面看吧 需要文档的朋友可以加下群哦,群内貌似也有两千多人了,有很多热爱python聚集在了一起,并整理了大量的学习资料上传到了群文件当中,喜欢python的朋友可以加入python群:526929231欢迎大家交流讨论各种技术,一起快速成长 通过阅读博客和文章,保持有关信息的新鲜度也很重要,PDF的书籍已经整理到了群文件当中
目录
一、简明概述
1、编码
2、代码格式
2.1、缩进
2.2、行宽
每行代码尽量不超过 80 个字符(在特殊情况下可以略微超过 80 ,但最长不得超过 120)
理由:
2.3、引号
简单说,自然语言使用双引号,机器标示使用单引号,因此 代码里 多数应该使用 单引号
例如错误信息;很多情况还是 unicode,使用u"你好世界"
例如 dict 里的 key
2.4、空行
-
模块级函数和类定义之间空两行;
-
类成员函数之间空一行;
-
可以使用多个空行分隔多组相关的函数
-
函数中可以使用空行分隔出逻辑相关的代码
2.5、编码
3、import 语句
4、空格
-
在二元运算符两边各空一格[=,-,+=,==,>,in,is not, and] :
5、换行
Python 支持括号内的换行。这时有两种情况。
1) 第二行缩进到括号的起始处
2) 第二行缩进 4 个空格,适用于起始括号就换行的情形
使用反斜杠换行,二元运算符+ .等应出现在行末;长字符串也可以用此法换行
禁止复合语句,即一行中包含多个语句:
if/for/while一定要换行:
6、docstring
docstring 的规范中最其本的两点:
-
所有的公共模块、函数、类、方法,都应该写 docstring 。私有方法不一定需要,但应该在 def 后提供一个块注释来说明。
-
docstring 的结束”“”应该独占一行,除非此 docstring 只有一行。
二、注释
1、注释
1.1、块注释
“#”号后空一格,段落件用空行分开(同样需要“#”号)
1.2、行注释
至少使用两个空格和语句分开,注意不要使用无意义的注释
1.3、建议
-
在代码的关键部分(或比较复杂的地方), 能写注释的要尽量写注释
-
比较重要的注释段, 使用多个等号隔开, 可以更加醒目, 突出重要性
2、文档注释(Docstring)
作为文档的Docstring一般出现在模块头部、函数和类的头部,这样在python中可以通过对象的__doc__对象获取文档.
编辑器和IDE也可以根据Docstring给出自动提示.
-
文档注释以 “”” 开头和结尾, 首行不换行, 如有多行, 末行必需换行, 以下是Google的docstring风格示例
-
文档注释不限于中英文, 但不要中英文混用
-
文档注释不是越长越好, 通常一两句话能把情况说清楚即可
-
模块、公有类、公有方法, 能写文档注释的, 应该尽量写文档注释
三、命名规范
1、模块
2、类名
3、函数
4、变量名
5、常量
通过阅读博客和文章,保持有关信息的新鲜度也很重要,有很多热爱python聚集在了一起,并整理了大量的学习资料上传到了群文件当中,PDF的书籍已经整理到了群文件当中,需要的朋友可以加下群,群内貌似也有两千多人了,喜欢python的朋友可以加入python群:526929231欢迎大家交流讨论各种技术,一起快速成长
|