蛇宗三字经(The Zen of Python)

本文内容,收集、转载于网络。

The Zen of Python

Long time Pythoneer Tim Peters succinctly channels the BDFL’s guiding principles for Python’s design into 20 aphorisms, only 19 of which have been written down.

The Zen of Python》是Tim Peters提出的19行指导原则,是Python开发者都应该反复阅读、理解、记忆、运用的信条。 在2004年,成为了PEP 20 – The Zen of Python。 任何当前的Python版本中,都可以简单打印出来。

比如,

>>> import this

或者,

$ python -c 'import this'
The Zen of Python, by Tim Peters

Beautiful is better than ugly.
Explicit is better than implicit.
Simple is better than complex.
Complex is better than complicated.
Flat is better than nested.
Sparse is better than dense.
Readability counts.
Special cases aren't special enough to break the rules.
Although practicality beats purity.
Errors should never pass silently.
Unless explicitly silenced.
In the face of ambiguity, refuse the temptation to guess.
There should be one-- and preferably only one --obvious way to do it.
Although that way may not be obvious at first unless you're Dutch.
Now is better than never.
Although never is often better than *right* now.
If the implementation is hard to explain, it's a bad idea.
If the implementation is easy to explain, it may be a good idea.
Namespaces are one honking great idea -- let's do more of those!

翻译

以下给出两种流行的翻译,整理于豆瓣的帖子《The Zen of Python》。

Python之禅

译者:赖勇浩。

Beautiful is better than ugly.

优美胜于丑陋(Python 以编写优美的代码为目标)

Explicit is better than implicit.

明了胜于晦涩(优美的代码应当是明了的,命名规范,风格相似)

Simple is better than complex.

简洁胜于复杂(优美的代码应当是简洁的,不要有复杂的内部实现)

Complex is better than complicated.

复杂胜于凌乱(如果复杂不可避免,那代码间也不能有难懂的关系,要保持接口简洁)

Flat is better than nested.

扁平胜于嵌套(优美的代码应当是扁平的,不能有太多的嵌套)

Sparse is better than dense.

间隔胜于紧凑(优美的代码有适当的间隔,不要奢望一行代码解决问题)

Readability counts.

可读性很重要(优美的代码是可读的)

Special cases aren’t special enough to break the rules.

Although practicality beats purity.

即便假借特例的实用性之名,也不可违背这些规则(这些规则至高无上)

Errors should never pass silently.

Unless explicitly silenced.

不要包容所有错误,除非你确定需要这样做(精准地捕获异常,不写 except:pass 风格的代码)

In the face of ambiguity, refuse the temptation to guess.

当存在多种可能,不要尝试去猜测

There should be one– and preferably only one –obvious way to do it.

而是尽量找一种,最好是唯一一种明显的解决方案(如果不确定,就用穷举法)

Although that way may not be obvious at first unless you’re Dutch.

虽然这并不容易,因为你不是 Python 之父(这里的 Dutch 是指 Guido )

Now is better than never.

Although never is often better than right now.

做也许好过不做,但不假思索就动手还不如不做(动手之前要细思量)

If the implementation is hard to explain, it’s a bad idea.

If the implementation is easy to explain, it may be a good idea.

如果你无法向人描述你的方案,那肯定不是一个好方案;反之亦然(方案测评标准)

Namespaces are one honking great idea – let’s do more of those!

命名空间是一种绝妙的理念,我们应当多加利用(倡导与号召)

蛇宗三字经

译者:元创。

Beautiful is better than ugly.

美胜丑

Explicit is better than implicit.

明胜暗

Simple is better than complex.

简胜复

Complex is better than complicated.

复胜杂

Flat is better than nested.

浅胜深

Sparse is better than dense.

疏胜密

Readability counts.

辞达意

Special cases aren’t special enough to break the rules.

不逾矩

Although practicality beats purity.

弃至清

Errors should never pass silently.

无阴差

Unless explicitly silenced.

有阳错

In the face of ambiguity, refuse the temptation to guess.

拒疑数

There should be one– and preferably only one –obvious way to do it.

求完一

Although that way may not be obvious at first unless you’re Dutch.

虽不至,向往之

Now is better than never.

敏于行

Although never is often better than right now.

戒莽撞

If the implementation is hard to explain, it’s a bad idea.

差难言

If the implementation is easy to explain, it may be a good idea.

好易说

Namespaces are one honking great idea – let’s do more of those!

每师出,多有名

点评

《蛇宗三字经》的翻译,堪称信、达、雅。 不过,它虽然容易记忆,却不易理解。 对于英文水平一般、Python经验很浅的初学者来说,《Python之禅》更容易读懂。

先读《Python之禅》,再背《蛇宗三字经》。


相关笔记