文件名

全小寫,可使用下劃線

包

應(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.私有類成員使用單一下劃線前綴標(biāo)識，多定義公開成員，少定義私有成員。
3.變量名不應(yīng)帶有類型信息，因為Python是動態(tài)類型語言。如 iValue、names_list、dict_obj 等都是不好的命名。

常量

常量名所有字母大寫，由下劃線連接各個單詞如MAX_OVERFLOW，TOTAL。

異常

以“Error”作為后綴。

縮寫

命名應(yīng)當(dāng)盡量使用全拼寫的單詞，縮寫的情況有如下兩種：

1.常用的縮寫，如XML、ID等，在命名時也應(yīng)只大寫首字母，如XmlParser。
2.命名中含有長單詞，對某個單詞進(jìn)行縮寫。這時應(yīng)使用約定成俗的縮寫方式。

例如：

function 縮寫為 fn
text 縮寫為 txt
object 縮寫為 obj
count 縮寫為 cnt
number 縮寫為 num，等。
前導(dǎo)后綴下劃線
一個前導(dǎo)下劃線：表示非公有。
一個后綴下劃線：避免關(guān)鍵字沖突。
兩個前導(dǎo)下劃線：當(dāng)命名一個類屬性引起名稱沖突時使用。
兩個前導(dǎo)和后綴下劃線：“魔”（有特殊用圖）對象或者屬性，例如__init__或者_(dá)_file__。絕對不要創(chuàng)造這樣的名字，而只是使用它們。

*注意*：關(guān)于下劃線的使用存在一些爭議。

特定命名方式

主要是指 __xxx__ 形式的系統(tǒng)保留字命名法。項目中也可以使用這種命名，它的意義在于這種形式的變量是只讀的，這種形式的類成員函數(shù)盡量不要重載。如

class Base(object):
def __init__(self, id, parent = None):
self.__id__ = id
self.__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)站的支持！

最新評論