一、變量
常量:大寫加下划線
USER_CONSTANT
對於不會發生改變的全局變量,使用大寫加下划線。
私有變量:小寫和一個前導下划線
_private_value
python中不存在私有變量一說,若是遇到需要保護的變量,使用小寫和一個前導下划線。但這只是程序員之間的一個約定,用於警告說明這是一個私有變量,外部類不要去訪問它。但實際上,外部類還是可以訪問到這個變量。
內置變量:小寫,兩個前導下划線和兩個后置下划線
__class__
兩個前導下划線會導致變量在解釋期間被更名。這是為了避免內置變量和其他變量產生沖突。用戶定義的變量要嚴格避免這種風格。以免導致混亂。
二、函數和方法
總體而言應該使用,小寫和下划線。但是有些比較老的庫使用的是混合大小寫,即首單詞小寫,之后每個單詞第一個字母大寫,其余小寫。但現在,小寫和下划線已成為規范。
私有方法:小寫和一個前導下划線
deff _secrete(self):
print ('don't test me')
這里和私有變量一樣,並不是真正的私有訪問權限。同時也應該注意一般函數不要使用兩個前導下划線(當遇到兩個前導下划線時,python的名稱改編特性將發揮作用)。特殊函數后面會提及。
特殊方法:小寫和兩個前導下划線,兩個后置下划線
def __add__(self,other):
return int.__add__(other)
這種風格只應用於特殊函數,比如操作符重載等。
函數參數:小寫和下划線,缺省值等號兩邊無空格
def connect(self,user=None):
self._user = user
三、類
類總是使用駝峰格式命名,即所有單詞首字母大寫其余字母小寫。類名應該簡明,精確,並足以從中理解類所完成的工作。常見的一個方式是使用表示其類型或者特性的后綴,例如:
SQLEngine
MimeTypes
對於基類而言,可以使用一個Base或者Abstract前綴
BaseCookie
AbstractGroup
class UserProfile(object):
def __init__(self,profile):
return self._profile = profile
def profile(self):
return self._profile
四、模塊和包
除特殊模塊 __init__ 之外,模塊名稱都使用不帶下划線的小寫字母。
若是它們實現一個協議,那么通常使用lib為后綴,例如:
import smtplib


五、關於參數
斷言可以用於檢查參數,但不應僅僅是進行靜態類型檢測。 Python 是動態類型語言,靜態類型檢測違背了其設計思想。斷言應該用於避免函數不被毫無意義的調用。
5.2 不要濫用 *args 和 **kwargs
*args 和 **kwargs 參數可能會破壞函數的健壯性。它們使簽名變得模糊,而且代碼常常開始在不應該的地方構建小的參數解析器。
六、總結