Python编程风格指引.PDF

Python 编程风格指南 Style Guide for Python Code Python 编程风格指南 Python 编程风格指南 Style Guide for Python Code Python 编程风格指南 [荷兰] Guido van Rossum Barry Warsaw Nick Coghlan 著 译：Gan /dev/peps/pep-0008/ Page 1 Python 编程风格指南 Style Guide for Python Code Python 编程风格指南 Python 编程风格指南 目录 快速进入 点击页码 第1 章 引言 3 第2 章 愚蠢的一致性是无知的妖怪3 第3 章 代码布局3 3.1 缩进 3 3.2 制表符或空格5 3.3 行的最大长度6 3.4 空行7 3.5 源文件编码7 3.6 导入 8 第4 章 字符串的引号9 第5 章 表达式和语句中的空白9 5.1 坏毛病9 5.2 其它建议 10 第6 章 注释 12 5.3 块注释 13 5.4 行注释 13 5.5 文档字符串 13 第7 章 版本标记 13 第8 章 命名约定 14 8.1 重要原则 14 8.2 描述：命名风格 14 8.3 规定：命名约定 15 8.3.1 避免的命名 15 8.3.2 封装和模块名 16 8.3.3 类名 16 8.3.4 异常名 16 8.3.5 全局变量名 16 8.3.6 函数名 16 8.3.7 函数和方法的参数 17 8.3.8 方法名和实例变量 17 8.3.9 常数 17 8.3.10 继承的设计 17 8.4 公共和内部接口 19 第9 章 编程建议 19 第10 章 参考文献 26 /dev/peps/pep-0008/ Page 2 Python 编程风格指南 Style Guide for Python Code Python 编程风格指南 Python 编程风格指南 第1章 引言 本文档所提供的Python 代码适用主Python 标准库的编码风格约定，请查阅PEP 在 Python[ 1] C 中实现的C 代码风格指南的相关描述。本文档和PEP 257 （文档字符串的约 定）是改编自Guido 最初的Python 风格指南的文章，并对Barry 的风格指南[ 2 ]做了一 些补充。这种额外约定的风格指南随着时间的推移已被认可，而过去的约定由于语言自身的 发展而被弃用。在许多工程项目中都有他们独自编码风格，当发生冲突时，都以Guido 的 风格为准。 返回目录 第2章 愚蠢的一致性是无知的妖怪 Guido 的重要见解是读代码比写代码更多，这里提供的准则旨在提高代码的可读性，使整 个Python 代码保持一致。正如PEP20 说，Readability counts。 风格指南是关于一致性。一致性对这种风格指南是非常重要的，对一个工程来说更加重要， 而对一个模块或函数是最重要的。 但最重要的是：知道何时会不一致 - 有时风格指南是不适用的。如果有疑问，请使用您的 最佳判断，看看其他的例子，决定什么最好看，多多请教别人！ 特别注意：不要仅仅为了符合这个PEP 而去破坏代码向后兼容性！下面是一些很好