Python之禪
如果你在使用Python,那么Python之禪的概念你必須要了解一下。Python社區(qū)的理念都包含其中,要獲悉關(guān)于Python之禪的所有內(nèi)容,只需要在終端啟動(dòng)Python并輸入‘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!
英文雖然部分人看著可能會(huì)比較吃力,但是翻譯過(guò)來(lái)的東西有些時(shí)候難免會(huì)變了味道。但是還是貼份中文版上來(lái),畢竟語(yǔ)言是座大山。
中文譯版
Python之禪 by Tim Peters
優(yōu)美勝于丑陋(Python 以編寫優(yōu)美的代碼為目標(biāo))
明了勝于晦澀(優(yōu)美的代碼應(yīng)當(dāng)是明了的,命名規(guī)范,風(fēng)格相似)
簡(jiǎn)潔勝于復(fù)雜(優(yōu)美的代碼應(yīng)當(dāng)是簡(jiǎn)潔的,不要有復(fù)雜的內(nèi)部實(shí)現(xiàn))
復(fù)雜勝于凌亂(如果復(fù)雜不可避免,那代碼間也不能有難懂的關(guān)系,要保持接口簡(jiǎn)潔)
扁平勝于嵌套(優(yōu)美的代碼應(yīng)當(dāng)是扁平的,不能有太多的嵌套)
間隔勝于緊湊(優(yōu)美的代碼有適當(dāng)?shù)拈g隔,不要奢望一行代碼解決問(wèn)題)
可讀性很重要(優(yōu)美的代碼是可讀的)
即便假借特例的實(shí)用性之名,也不可違背這些規(guī)則(這些規(guī)則至高無(wú)上)
不要包容所有錯(cuò)誤,除非你確定需要這樣做(精準(zhǔn)地捕獲異常,不寫 except:pass 風(fēng)格的代碼)
當(dāng)存在多種可能,不要嘗試去猜測(cè)
而是盡量找一種,最好是唯一一種明顯的解決方案(如果不確定,就用窮舉法)
雖然這并不容易,因?yàn)槟悴皇?Python 之父(這里的 Dutch 是指 Guido )
做也許好過(guò)不做,但不假思索就動(dòng)手還不如不做(動(dòng)手之前要細(xì)思量)
如果你無(wú)法向人描述你的方案,那肯定不是一個(gè)好方案;反之亦然(方案測(cè)評(píng)標(biāo)準(zhǔn))
命名空間是一種絕妙的理念,我們應(yīng)當(dāng)多加利用(倡導(dǎo)與號(hào)召)
優(yōu)秀的程序員總是能夠使用更少的代碼來(lái)做更多的事情,而學(xué)好Tim Peters給你的建議是你成為Python高手的第一步
如何寫注釋
注釋的作用
注釋的主要目的是闡述代碼功能,要做什么以及如何做。一個(gè)專業(yè)的程序員總是會(huì)有寫注釋的習(xí)慣,注釋能將復(fù)雜難懂的代碼轉(zhuǎn)換成自然語(yǔ)言,可以讓你或者合作伙伴快速的閱讀程序。這對(duì)開(kāi)源項(xiàng)目以及公司多人協(xié)作項(xiàng)目的發(fā)展有著重要意義
哪里該寫注釋
思考在你解決問(wèn)題前是否想了多種解決辦法,如果是肯定的那就應(yīng)該編寫注釋進(jìn)行說(shuō)明
如何編寫注釋
在你要描述的內(nèi)容前加‘#’。Python會(huì)忽略井號(hào)(#)之后的內(nèi)容
#輸出Hello World
print('Hello World')