包
應(yīng)該是簡短的、小寫的名字。如果下劃線可以改善可讀性可以加入。如mypackage。
模塊
與包的規(guī)范同。如mymodule。
類
總是使用首字母大寫單詞串。如MyClass。內(nèi)部類可以使用額外的前導(dǎo)下劃線。
函數(shù)&方法
函數(shù)名應(yīng)該為小寫，可以用下劃線風(fēng)格單詞以增加可讀性。如：myfunction，my_example_function。
*注意*：混合大小寫僅被允許用于這種風(fēng)格已經(jīng)占據(jù)優(yōu)勢的時候，以便保持向后兼容。
函數(shù)和方法的參數(shù)
總使用“self”作為實例方法的第一個參數(shù)?？偸褂谩癱ls”作為類方法的第一個參數(shù)。
如果一個函數(shù)的參數(shù)名稱和保留的關(guān)鍵字沖突，通常使用一個后綴下劃線好于使用縮寫或奇怪的拼寫。
全局變量
對于from M import *導(dǎo)入語句，如果想阻止導(dǎo)入模塊內(nèi)的全局變量可以使用舊有的規(guī)范，在全局變量上加一個前導(dǎo)的下劃線。
*注意*:應(yīng)避免使用全局變量
變量
變量名全部小寫，由下劃線連接各個單詞。如color = WHITE，this_is_a_variable = 1
*注意*：
1.不論是類成員變量還是全局變量，均不使用 m 或 g 前綴。
2.私有類成員使用單一下劃線前綴標識，多定義公開成員，少定義私有成員。
3.變量名不應(yīng)帶有類型信息，因為Python是動態(tài)類型語言。如 iValue、names_list、dict_obj 等都是不好的命名。
常量
常量名所有字母大寫，由下劃線連接各個單詞如MAX_OVERFLOW，TOTAL。
異常
以“Error”作為后綴。
縮寫
命名應(yīng)當盡量使用全拼寫的單詞，縮寫的情況有如下兩種：
1.常用的縮寫，如XML、ID等，在命名時也應(yīng)只大寫首字母，如XmlParser。
2.命名中含有長單詞，對某個單詞進行縮寫。這時應(yīng)使用約定成俗的縮寫方式。
例如：
function 縮寫為 fn
text 縮寫為 txt
object 縮寫為 obj
count 縮寫為 cnt
number 縮寫為 num，等。
前導(dǎo)后綴下劃線
一個前導(dǎo)下劃線：表示非公有。
一個后綴下劃線：避免關(guān)鍵字沖突。
兩個前導(dǎo)下劃線：當命名一個類屬性引起名稱沖突時使用。
兩個前導(dǎo)和后綴下劃線：“魔”（有特殊用圖）對象或者屬性，例如__init__或者__file__。絕對不要創(chuàng)造這樣的名字，而只是使用它們。
*注意*：關(guān)于下劃線的使用存在一些爭議。
特定命名方式
主要是指 __xxx__ 形式的系統(tǒng)保留字命名法。項目中也可以使用這種命名，它的意義在于這種形式的變量是只讀的，這種形式的類成員函數(shù)盡量不要重載。如
1 2 3 4 5 6 | class Base(object): def __init__(self, id, parent = None): self.__id__ = idself.__parent__ = parent def __message__(self, msgid): # …略 |
其中 __id__、__parent__ 和 __message__ 都采用了系統(tǒng)保留字命名法。
附:Google Python命名規(guī)范
module_name, package_name, ClassName, method_name, ExceptionName, function_name, GLOBAL_VAR_NAME, instance_var_name, function_parameter_name, local_var_name.
總結(jié)
以上所述是小編給大家介紹的python里的命名規(guī)范，希望對大家有所幫助，如果大家有任何疑問請給我留言，小編會及時回復(fù)大家的。在此也非常感謝大家對腳本之家網(wǎng)站的支持！
聯(lián)系客服
