1.规范文档
为了方便维护、他人阅读,整理出该编码规范文档。请大家开发时遵循本规范进行更开发
本文档参考Guido的《Python风格指南》一文,并从《Barry's》
2.一致性的建议
整个项目的开发中,请尽量保持一致性,尤其是一个模块或者一个函数中的一致性更为重要
因此存在这样的一个问题,由于不同模块的lib库开发人不同,编码规范也可能不同,整合起来会显得不够“和谐”。还是希望各模块lib库负责人做想对应的修改,尽量“和谐”
3.代码的布局
3.1 缩进
众所周知,Python是通过缩进来进行代码布局的。使用vi 可以在~/.vimrc中配置几个空格来代表一个tab,从而来布局Python函数的缩进。
3.2.Tab键还是空格
Python里面有叫“以空格为荣,以用tab键为耻”。但全用空格时确实很麻烦。因此,这里不限定tab键还是空格。但记 住:'不可混用!'
3.3.行的最大长度
类似于函数中的行注释、函数体等,如果某一行很长,则导致换行折叠看,很影响美观,而且还不利于阅读。因此,对顺序排放的大块文本(文档字符串或者注释),推荐长度限制在72个字节内。推荐使用反斜杠
3.4.空行
用两行分隔顶层函数和类的定义。
用一行分割类成员方法的定义。
在一个函数内使用空行时请注意谨慎使用于一个逻辑段。
3.5.编码
在python2.4之后内核已经开始支持Unicode了,无论