PEP 8 -- Style Guide for Python Code
Introduction
介绍
This document gives coding conventions for the Python code comprising the standard library in the main Python distribution.
本文给出主Python版本标准库的编码约定。
Please see the companion informational PEP describing style guidelines for the C code in the C implementation of Python [1].
CPython的C代码风格参见PEP7。
his document and PEP 257(Docstring Conventions) were adapted from Guido"s original Python Style Guide essay, with some additions from Barry"s style guide [2].
本文和PEP 257 文档字符串标准改编自Guido最初的《Python Style Guide》, 并增加了Barry的GNU Mailman Coding Style Guide的部分内容。
This style guide evolves over time as additional conventions are identified and past conventions are rendered obsolete by changes in the language itself.
许多项目都有自己的编码风格指南,冲突时自己的指南为准。
A Foolish Consistency is the Hobgoblin of Little Minds
一致性考虑
One of Guido"s key insights is that code is read much more often than it is written.
Guido的关键点之一是:代码更多是用来读而不是写。
The guidelines provided here are intended to improve the readability of code and make it consistent across the wide spectrum of Python code. As PEP 20says, "Readability counts".
指南旨在改善Python代码的可读性,即PEP 20所说的“可读性计数"(Readability counts)。