Python Coding Rule---hoxide初译 dreamingk校对发布 040724---xyb重新排版 040915---ZoomQuietMoinMoin 美化 0506101
介绍这篇文档所给出的编码约定适用于在主要的Python发布版本中组成标准库的Python 代码
请查阅相关的关于在Python的C实现中C代码风格指南的描述
这篇文档改编自Guido最初的《Python风格指南》一文
并从《Barry'sstyle guide》中添加了部分内容
在有冲突的地方,Guide的风格规则应该是符合本PEP的意图 (译注:就是当有冲突时,应以Guido风格为准) 这篇PEP也许仍然尚未完成(实际上,它可能永远不会结束)
一致性的建议愚蠢得使用一致性是无知的妖怪(A Foolish Consistency is the Hobgoblin of Little Minds)呆板的坚持一致性是傻的没边了
--Zoomq在这篇风格指导中的一致性是重要的
在一个项目内的一致性更重要
在一个模块或函数内的一致性最重要
但最重要的是:知道何时会不一致 --有时只是没有实施风格指导
当出现疑惑时,运用你的最佳判断
看看别的例子,然后决定怎样看起来更好
并且要不耻下问
打破一条既定规则的两个好理由:当应用这个规则是将导致代码可读性下降,即便对某人来说,他已经习惯于按这条规则来阅读代码了
为了和周围的代码保持一致而打破规则(也许是历史原因)--虽然这也是个清除其它混乱的好机会(真正的XP风格)
代码的布局(Codelay-out)1
缩进(Indentation)使用Emacs的Python-mode的默认值:4个空格一个缩进层次
对于确实古老的代码,你不希望产用Python进行开发时的编码风格约定原 文 :