1. 縮進(jìn)
是通過(guò)縮進(jìn)來(lái)表示代碼塊的,因此縮進(jìn)應(yīng)該是 4 個(gè)空格。不要使用 Tab,因?yàn)樵诓煌木庉嬈髦校琓ab 可能會(huì)被解釋成不同數(shù)量的空格。
2. 行寬
每行代碼的長(zhǎng)度應(yīng)該不超過(guò) 79 個(gè)字符。如果一行代碼超過(guò)了這個(gè)長(zhǎng)度,可以使用括號(hào)或反斜杠來(lái)進(jìn)行換行。在使用括號(hào)或反斜杠進(jìn)行換行時(shí),應(yīng)該將它們放在行末。
3. 空行
在函數(shù)和類(lèi)之間應(yīng)該有兩個(gè)空行。在類(lèi)的方法之間應(yīng)該有一個(gè)空行。在函數(shù)或方法內(nèi)部,可以使用空行來(lái)分隔代碼塊,以提高可讀性。
4. 導(dǎo)入
中,應(yīng)該盡量避免使用通配符導(dǎo)入,因?yàn)檫@會(huì)導(dǎo)致命名空間污染。應(yīng)該只導(dǎo)入需要的模塊和函數(shù)。多個(gè)導(dǎo)入應(yīng)該分別寫(xiě)在不同的行上。
5. 命名
變量和函數(shù)名應(yīng)該使用小寫(xiě)字母,單詞之間用下劃線分隔。類(lèi)名應(yīng)該使用駝峰命名法,即單詞首字母大寫(xiě),其余字母小寫(xiě)。
6. 注釋
注釋?xiě)?yīng)該使用英文,并在代碼的上方或右側(cè)進(jìn)行注釋。注釋?xiě)?yīng)該簡(jiǎn)明扼要,不要重復(fù)代碼功能。如果代碼發(fā)生變化,注釋也應(yīng)該隨之進(jìn)行修改。
7. 函數(shù)
8. 異常
ally 結(jié)構(gòu),并在 except 中處理特定的異常。如果需要拋出異常,應(yīng)該使用 raise。
9. 其他
特有的語(yǔ)法糖,以提高代碼的可讀性和可維護(hù)性。
代碼非常重要。應(yīng)該遵守以上規(guī)范和要求,以提高代碼的質(zhì)量和可維護(hù)性。