一、分號
拋棄語句末的分號,也意味著一行不允許寫倆個語句
二、空:空格、空行、縮進(jìn)
使用四個空格來縮進(jìn)
一個語句寫成多行的時候,第二行要么懸掛縮進(jìn),要么四個空格
類方法間一個空行,類或全局函數(shù)之間兩個空行
『:』、『,』后邊有一個空格
雙目運算符左右各一個空格
三、注釋:
- 文件聲明必須用"""的方式,格式如下,包括版權(quán)聲明、功能介紹、作者聯(lián)系方式、時間
[圖片上傳中...(image-119efd-1656486236250-1)]
- 對外接口必須使用docstring,包括功能、輸入?yún)?shù)及返回值語義、可能拋出的異常
[圖片上傳中...(image-1fa4a3-1656486236250-0)]
- 內(nèi)部借口自行選擇,盡量有必須使用docstring。
四、包引用
禁止只導(dǎo)入某一個函數(shù)或者類
每行只寫一個庫
自上而下的導(dǎo)入順序分為:標(biāo)準(zhǔn)庫、第三方庫、自建庫
五、標(biāo)識符
局部變量全部小寫
全局變量全部大寫
變量的單詞間用_,函數(shù)的單詞間才駝峰(首字母大寫)
六、函數(shù)
僅可以把基本類型作為輸入?yún)?shù)的默認(rèn)值
構(gòu)造函數(shù)如果復(fù)雜就定義一個init方法
protected變量/方法明明為_abc,private變量命名為__abc,在被import時不會被導(dǎo)入
必須有基類,沒有的話就object
七、異常
禁止使用雙參數(shù)方式或者字符型式拋出異常(那怎么拋呢?)
盡量指catch自定義異常,除非再次拋出異常否則不允許catch全部異常
禁止使用excapt XXX,e而是使用xcapt XXX as e