
掃描右側(cè)圖片或微信搜索 “ Java技術(shù)分享屋 ” ,回復(fù) “ 驗(yàn)證碼 ” ,獲取驗(yàn)證密碼。
本資料僅供讀者預(yù)覽及學(xué)習(xí)交流使用,不能用于商業(yè)用途,請(qǐng)?jiān)谙螺d后24小時(shí)內(nèi)刪除。如果喜歡,請(qǐng)購(gòu)買(mǎi)正版!
一.資料圖片
二.資料簡(jiǎn)介
本文提供的Python代碼編碼規(guī)范基于Python主要發(fā)行版本的標(biāo)準(zhǔn)庫(kù)。Python的C語(yǔ)言實(shí)現(xiàn)的C代碼規(guī)范請(qǐng)查看相應(yīng)的PEP指南[1]。 這篇文檔以及PEP 257(文檔字符串的規(guī)范)改編自Guido原始的《Python Style Guide》一文,同時(shí)添加了一些來(lái)自Barry的風(fēng)格指南[2]。 這篇規(guī)范指南隨著時(shí)間的推移而逐漸演變,隨著語(yǔ)言本身的變化,過(guò)去的約定也被淘汰了。 許多項(xiàng)目有自己的編碼規(guī)范,在出現(xiàn)規(guī)范沖突時(shí),項(xiàng)目自身的規(guī)范優(yōu)先。
Guido的一條重要的見(jiàn)解是代碼閱讀比寫(xiě)更加頻繁。這里提供的指導(dǎo)原則主要用于提升代碼的可讀性,使得在大量的Python代碼中保持一致。 就像PEP 20提到的,“Readability counts”。 這是一份關(guān)于一致性的風(fēng)格指南。這份風(fēng)格指南的風(fēng)格一致性是非常重要的。更重要的是項(xiàng)目的風(fēng)格一致性。在一個(gè)模塊或函數(shù)的風(fēng)格一致性 是最重要的。 然而,應(yīng)該知道什么時(shí)候應(yīng)該不一致,有時(shí)候編碼規(guī)范的建議并不適用。當(dāng)存在模棱兩可的情況時(shí),使用自己的判斷??纯雌渌氖纠?zèng)Q定 哪一種是最好的,不要羞于發(fā)問(wèn)。 特別是不要為了遵守PEP約定而破壞兼容性! 幾個(gè)很好的理由去忽略特定的規(guī)則: 當(dāng)遵循這份指南之后代碼的可讀性變差,甚至是遵循PEP規(guī)范的人也覺(jué)得可讀性差。 與周?chē)拇a保持一致(也可能出于歷史原因),盡管這也是清理他人混亂(真正的Xtreme Programming風(fēng)格)的一個(gè)機(jī)會(huì)。 有問(wèn)題的代碼出現(xiàn)在發(fā)現(xiàn)編碼規(guī)范之前,而且也沒(méi)有充足的理由去修改他們。 當(dāng)代碼需要兼容不支持編碼規(guī)范建議的老版本Python。