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