python命名規範

2021-06-18 09:03:06 字數 3293 閱讀 9192

常量:

常量名所有字母大寫,由下劃線連線各個單詞,如

white = 0xffffff

this_is_a_constant = 1

變數:1.普通變數:

全部小寫,由下劃線連線各個單詞,如:

1color = white

2this_is_a_variable = 1

2.保護成員變數:

單下劃線作字首,意思是只有類物件和子類物件自己能訪問到這些變數,且不能用'from module import *'匯入。如:

1_name=name

3.私有成員變數:

雙下劃線作字首,意思是只有類物件自己能訪問,連子類物件也不能訪問到這個資料。

1__ha=ha

4.全域性變數:

大寫字母,單詞之間用_分割。

對於from m import *匯入語句,如果想阻止匯入模組內的全域性變數可以使用舊有的規範,在全域性變數上加乙個前導的下劃線

1number

2color_write

5. 注意:

(1) 不論是類成員變數還是全域性變數,均不使用 m 或 g 字首

(2)變數名不應帶有型別資訊,因為 python 是動態型別語言。如 ivalue、names_list、dict_obj 等都是不好的命名。

函式:1. 普通函式:

與普通變數一致,函式名應該為小寫,可以用下劃線風格單詞以增加可讀性。

混合大小寫僅被允許用於這種風格已經佔據優勢的時候,以便保持向後相容

1myfunctio()

2my_example_function()

3myname()

2. 私有函式:

以雙下劃線開頭。如:

1__get_name()

3.函式的引數: 

總使用「self」作為例項方法的第乙個引數。總使用「cls」作為類方法的第乙個引數。

如果乙個函式的引數名稱和保留的關鍵字衝突,通常使用乙個字尾下劃線好於使用縮寫或奇怪的拼寫。

模組:應該是簡短的、小寫的名字,單詞之間用_分割。模組就是指檔案

1hello.py

2ad_stats.py

類:類名單詞首字母大寫,不使用下劃線連線單詞,也不加入 c、t 等字首

例項用小寫字母

1class myclass(object)

包:命名方式同模組,是資料夾

特定命名方式:__***__

主要是指 __***__ 形式的系統保留字命名法。專案中也可以使用這種命名,它的意義在於這種形式的變數是唯讀的,這種形式的類成員函式盡量不要過載。如

class base(object):

def __init__(self, id, parent = none):

self.__id__ = id

self.__parent__ = parent

def __message__(self, msgid):

# …略

其中 __id__、__parent__ 和 __message__ 都採用了系統保留字命名法。

檔名全小寫,可使用下劃線

包應該是簡短的、小寫的名字。如果下劃線可以改善可讀性可以加入。如mypackage。

模組與包的規範同。如mymodule。

類總是使用首字母大寫單詞串。如myclass。內部類可以使用額外的前導下劃線。

函式&方法

函式名應該為小寫,可以用下劃線風格單詞以增加可讀性。如:myfunction,my_example_function。

*注意*:混合大小寫僅被允許用於這種風格已經佔據優勢的時候,以便保持向後相容。

函式和方法的引數

總使用「self」作為例項方法的第乙個引數。總使用「cls」作為類方法的第乙個引數。

如果乙個函式的引數名稱和保留的關鍵字衝突,通常使用乙個字尾下劃線好於使用縮寫或奇怪的拼寫。

全域性變數

對於from m import *匯入語句,如果想阻止匯入模組內的全域性變數可以使用舊有的規範,在全域性變數上加乙個前導的下劃線。

*注意*:應避免使用全域性變數

變數變數名全部小寫,由下劃線連線各個單詞。如color = white,this_is_a_variable = 1

*注意*:

1.不論是類成員變數還是全域性變數,均不使用 m 或 g 字首。

2.私有類成員使用單一下劃線字首標識,多定義公開成員,少定義私有成員。

3.變數名不應帶有型別資訊,因為python是動態型別語言。如 ivalue、names_list、dict_obj 等都是不好的命名。

常量常量名所有字母大寫,由下劃線連線各個單詞如max_overflow,total。

異常以「error」作為字尾。

縮寫命名應當盡量使用全拼寫的單詞,縮寫的情況有如下兩種:

1.常用的縮寫,如xml、id等,在命名時也應只大寫首字母,如xmlparser。

2.命名中含有長單詞,對某個單詞進行縮寫。這時應使用約定成俗的縮寫方式。

例如:function 縮寫為 fn

text 縮寫為 txt

object 縮寫為 obj

count 縮寫為 cnt

number 縮寫為 num,等。

前導字尾下劃線

乙個前導下劃線:表示非公有。

乙個字尾下劃線:避免關鍵字衝突。

兩個前導下劃線:當命名乙個類屬性引起名稱衝突時使用。

兩個前導和字尾下劃線:「魔」(有特殊用圖)物件或者屬性,例如__init__或者__file__。絕對不要創造這樣的名字,而只是使用它們。

*注意*:關於下劃線的使用存在一些爭議。

特定命名方式

主要是指 __***__ 形式的系統保留字命名法。專案中也可以使用這種命名,它的意義在於這種形式的變數是唯讀的,這種形式的類成員函式盡量不要過載。如

class base(object):

def __init__(self, id, parent = none):

self.__id__ = id

self.__parent__ = parent

def __message__(self, msgid):

# …略

其中 __id__、__parent__ 和 __message__ 都採用了系統保留字命名法。

附:google python命名規範

module_name, package_name, classname, method_name, exceptionname, function_name, global_var_name, instance_var_name, function_parameter_name, local_var_name.

Python命名規範

常量 常量名所有字母大寫,由下劃線連線各個單詞,如 white 0xffffff this is a constant 1 變數 1.普通變數 全部小寫,由下劃線連線各個單詞,如 1color white 2this is a variable 1 2.保護成員變數 單下劃線作字首,意思是只有類物件...

python命名規範

常量 常量名所有字母大寫,由下劃線連線各個單詞,如 white 0xffffff this is a constant 1 變數 1.普通變數 全部小寫,由下劃線連線各個單詞,如 1color white 2this is a variable 1 2.保護成員變數 單下劃線作字首,意思是只有類物件...

python 命名規範

原文 檔名 全小寫,可使用下劃線 包 簡短 小寫的名字 模組 簡短 小寫的名字 類 總是使用首字母大寫單詞串,如 myclass。函式 方法 函式名應該為小寫,可十一年下劃線增加可讀性。如 myfunctiong,my example 函式和方法的引數 總使用 self 作為例項方法的第乙個引數。總...