模塊(Modules)

模塊是 Python 代碼中一個(gè)基本的組織單位晾浴，被import system創(chuàng)建负乡，可通過import語句（查看import）,調(diào)用類似importlib.import_module()函數(shù)，或者內(nèi)建__import__()函數(shù)調(diào)用脊凰。模塊對象有一個(gè)用字典對象（被定義在該模塊中的函數(shù)屬性__globals__引用的字典）表示的命名空間抖棘。為了能在字典中查找，屬性引用會(huì)被轉(zhuǎn)化狸涌，例如：m.x與m.__dict__["x"]相同切省。模塊對象不包含實(shí)例化模塊的代碼對象（因?yàn)橐坏┠K初始化完畢，就不需要該對象了）帕胆。

給屬性賦值會(huì)更新模塊的命名空間字典朝捆，例如：m.x = 1與m.__dict__["x"] = 1相同。

特殊的只讀屬性：__dict__是模塊的命名空間懒豹，以字典對象形式存在芙盘。

CPython 實(shí)現(xiàn)細(xì)節(jié)：根據(jù) CPython 清空模塊字典的方式，即使仍有可用引用指向模塊字典脸秽，它也會(huì)在模塊超出范圍后被清空儒老。為了避免這種情況發(fā)生，在直接使用模塊的字典時(shí)豹储，你可以拷貝該字典或確保模塊不超出范圍贷盲。

預(yù)定義可寫屬性：__name__是模塊名；__doc__是模塊的文檔字符串，如果不可用則為None巩剖；如果從一個(gè)文件中加載模塊铝穷，則__file__是加載該模塊的文件的路徑名。__file__屬性在某些模塊中不存在佳魔，比如靜態(tài)鏈接到解釋器的 C 模塊曙聂；對于從共享庫中動(dòng)態(tài)加載的擴(kuò)展模塊而言，__file__是共享庫文件的路徑名鞠鲜。

自定義類

自定義類型通常通過類定義說明（參考類定義說明章節(jié)）創(chuàng)建宁脊。自定義類都有一個(gè)用字典對象表示的命名空間。為了能在字典中查找贤姆，屬性引用會(huì)被轉(zhuǎn)化榆苞。例如：C.x會(huì)轉(zhuǎn)化為C.__dict__["x"]（盡管有一些允許通過其他方式定位屬性的鉤子）。當(dāng)屬性不在自定義類時(shí)霞捡，會(huì)繼續(xù)在基類中尋找該屬性坐漏。Python 使用 C3 方法解析順序（C3 method resolution order）在基類中查找，該方法即使在“寶石”繼承結(jié)構(gòu)（多個(gè)繼承路徑指向同一個(gè)祖先）中也表現(xiàn)得體碧信。 C3 MRO 的詳細(xì)信息可在伴隨 2.3 版本發(fā)行的文檔中查看：https://www.python.org/download/releases/2.3/mro/赊琳。

當(dāng)一個(gè)類（比如類C）的屬性引用指向一個(gè)類方法對象時(shí)，它會(huì)被轉(zhuǎn)化為__self__屬性為 C 的實(shí)例方法對象砰碴。當(dāng)指向一個(gè)靜態(tài)方法對象是躏筏，它會(huì)被轉(zhuǎn)化為靜態(tài)方法對象的包裝對象。查看實(shí)現(xiàn)描述符章節(jié)中另一種從類中檢索的屬性的方法呈枉，此方法檢索出的屬性可能與在__dict__中實(shí)際包含的不同趁尼。

類的屬性賦值會(huì)更新類的字典，基類字典不會(huì)更新猖辫。

類對象可以被調(diào)用（參考上面）來指向一個(gè)類實(shí)例（參考下面）弱卡。

特殊屬性：__name__是類名；__module__是類定義所在模塊的模塊名住册；__dict__是包含類命名空間的字典；__bases__是一個(gè)包含基類的元組（可能為空或單元組）瓮具，在基類列表中以它們出現(xiàn)的順序排列荧飞；__doc__是類的文檔字符串，如果不可用則為None名党。

類實(shí)例

類實(shí)例通過調(diào)用類對象創(chuàng)建（參考上面）叹阔。類實(shí)例有一個(gè)以字典形式實(shí)現(xiàn)的命名空間，該字典是檢索屬性引用時(shí)的首選位置传睹。當(dāng)屬性不在字典中耳幢，而實(shí)例對應(yīng)的類有此屬性時(shí)，會(huì)繼續(xù)搜索類中的屬性。如果一個(gè)類的屬性是自定義函數(shù)對象睛藻，它會(huì)被轉(zhuǎn)化為一個(gè)__self__屬性是該實(shí)例的實(shí)例方法對象启上。靜態(tài)方法和類方法對象也會(huì)被轉(zhuǎn)化；參考上面的“類”店印。查看實(shí)現(xiàn)描述符章節(jié)中另一種從類實(shí)例中檢索類屬性的方法冈在，此方法檢索出的屬性可能與在類的__dict__中實(shí)際包含的不同。如果類屬性沒有找到按摘，并且對象對應(yīng)的類有__getattr__()方法包券，該方法會(huì)被調(diào)用以用來查找。

賦值或刪除屬性會(huì)更新實(shí)例字典炫贤，類字典不會(huì)更新溅固。如果類有__setattr__()或__delattr__()方法，該方法會(huì)被調(diào)用兰珍，而不是直接更新實(shí)例字典侍郭。

如果類實(shí)例有一些特定名稱的方法，它們可以偽裝成數(shù)字俩垃，序列励幼，或者映射集合。參考特定方法名章節(jié)口柳。
特殊屬性：__dict__是一個(gè)字典屬性苹粟；__class__是一個(gè)實(shí)例對應(yīng)的類。

I/O 對象(也被稱為文件對象)

文件對象代表了一個(gè)打開的文件跃闹。有很多創(chuàng)建對象的捷徑：內(nèi)建函數(shù)open()嵌削，os.popen()，os.fopen()和 socket 對象的makefile()方法（也可能通過其他擴(kuò)展模塊中的方法創(chuàng)建）望艺。

sys.stdin苛秕，sys.stdout，sys.stderr對象被初始化為文件按對象找默，分別對應(yīng)解釋器的標(biāo)準(zhǔn)輸入艇劫，輸出和錯(cuò)誤流；它們都是以文本模式打開惩激，遵守符合io.TextIOBase抽象類的接口定義店煞。

內(nèi)部類型

少數(shù)被解釋器內(nèi)部使用的類型暴露給了用戶。它們的定義可能會(huì)在在未來版本的解釋器中改變风钻，但是為了保持完整性顷蟀，此處還是提及了他們。

代碼對象(Code objects)

代碼對象代表字節(jié)編譯（byte-compiled）的可執(zhí)行 Python 代碼骡技，或者是字節(jié)碼鸣个。代碼對象和函數(shù)對象的區(qū)別在于：函數(shù)對象包含一個(gè)明確的對函數(shù)全局的引用（函數(shù)定義所在模塊），而代碼對象不包含上下文；而且默認(rèn)參數(shù)值會(huì)存在函數(shù)對象中囤萤，而不在代碼對象中昼窗，因?yàn)樗麄兇磉\(yùn)行時(shí)被計(jì)算出的值。不像函數(shù)對象阁将，代碼對象是不可變的而且不包含對（直接或繼承的）可變對象的引用膏秫。

特殊的制度屬性：co_name給出函數(shù)名；co_argcount是位置參數(shù)（positional arguments）的個(gè)數(shù)（包含帶默認(rèn)值的參數(shù)）做盅；co_nlocals是供函數(shù)使用的局部變量（包含參數(shù)）的個(gè)數(shù)缤削；co_varnames是一個(gè)包含局部變量名的元組（從參數(shù)名開始）；co_cellvars是一個(gè)包含被嵌套函數(shù)引用的局部變量名的元組吹榴；co_freevars是一個(gè)包含自由變量名的元組亭敢；co_code是一個(gè)代表字節(jié)碼指令序列的字符串；co_consts是一個(gè)包含字節(jié)碼使用的字面值的元組图筹；co_names是一個(gè)包含被字節(jié)碼使用的名稱的元組帅刀；co_filename 是被編譯代碼所在的文件名；co_firstlineno是函數(shù)的第一行的行號远剩；co_lnotab是一個(gè)編碼從字節(jié)碼坐標(biāo)到行號的映射集合的字符串（查看解釋器源碼獲取詳細(xì)信息）扣溺；co_stacksize是請求的棧大小（包括局部變量）瓜晤；co_flags是一個(gè)編碼了一些解釋器標(biāo)識的整數(shù)锥余。

以下是為co_flags定義的標(biāo)志位：如果函數(shù)使用了*arguments語法來接受任意個(gè)位置參數(shù)，則放置標(biāo)志位0x04痢掠；如果函數(shù)使用了**keywords語法來接受任意鍵值對參數(shù)驱犹，則放置標(biāo)識位0x08；如果函數(shù)是一個(gè)生成器足画，則放置標(biāo)志位0x20雄驹。

將來特性聲明（from __future__ import division）也用co_flags中的標(biāo)志位來標(biāo)識代碼對象使用一個(gè)指定特性編譯的功能是否開啟：如果函數(shù)使用將來版本編譯功能開啟，則放置標(biāo)志位0x2000淹辞；在早期的 Python 版本中使用0x10和0x1000医舆。

co_flags的其他標(biāo)志位僅供內(nèi)部使用。

如果一個(gè)代碼對象代表一個(gè)函數(shù)象缀，那么co_consts的第一個(gè)元素是函數(shù)的文檔字符串彬向，如果不可達(dá)則為None。

幀對象(Frame objects)

幀對象代表執(zhí)行幀攻冷。他們可能會(huì)出現(xiàn)在跟蹤對象中（參考下面）。

特殊的只讀屬性：f_back指向之前的棧幀（用于調(diào)用者）遍希，如果當(dāng)前已經(jīng)在棧幀底部等曼，則為None；f_code是幀中將要被執(zhí)行的代碼對象；f_locals是用來查找局部變量的字典禁谦；f_globals是用來查找全局變量的字典胁黑；f_buitins用于內(nèi)建（固有的）名字；f_lasti給予精確地說明（是進(jìn)入到代碼對象字節(jié)碼字符串的索引）州泊。

特殊的可寫屬性：f_trace如果不是None丧蘸，則為在每行源碼開頭處被調(diào)用的函數(shù)（用來調(diào)試）；f_lineno是幀當(dāng)前的行號——在跟蹤函數(shù)內(nèi)部寫入此屬性遥皂，可以跳轉(zhuǎn)到指定行（只針對最底層的幀使用）力喷。通過向 f_lineno 寫入，調(diào)試者可以實(shí)現(xiàn)一個(gè)跳轉(zhuǎn)命令（也稱為設(shè)置下一條語句）演训。

幀對象支持一個(gè)方法：

frame.clear()
此方法清空幀持有的所有局部變量引用弟孟。同時(shí)，如果幀屬于一個(gè)生成器样悟，則生成器是最終化（finalized）的拂募。此方法有助于打破對幀對象的循環(huán)引用（例如：當(dāng)捕獲到一個(gè)異常并存儲(chǔ)它的跟蹤信息，以備后來使用）窟她。

如果幀正在執(zhí)行陈症，則拋出RuntimeError異常。

3.4版本新添加震糖。

跟蹤對象

跟蹤對象代表一個(gè)異常的堆棧蹤跡（stack trace）录肯。當(dāng)發(fā)生異常時(shí)跟蹤對象被創(chuàng)建。當(dāng)異常處理器展開執(zhí)行棧進(jìn)行搜索時(shí)试伙，在每個(gè)展開層次中的跟蹤對象都會(huì)插在當(dāng)前跟蹤對象的前面嘁信。當(dāng)異常處理器介入后，堆棧蹤跡對程序可訪問疏叨。（參照try 語句章節(jié)潘靖。）它作為被sys.exc_info()返回的tuple中的第三個(gè)元素被訪問。當(dāng)程序沒有合適的處理器時(shí)蚤蔓，堆棧蹤跡以良好的格式被寫入標(biāo)準(zhǔn)錯(cuò)誤流中卦溢；如果解釋器是交互式的，用戶也可以通過sys.last_traceback獲取到它秀又。

特殊的只讀屬性：tb_next表示堆棧蹤跡的下一個(gè)層次（指向程序發(fā)生異常處的幀）单寂，如果沒有下一層次則為None；tb_frame指向當(dāng)前層次的執(zhí)行幀吐辙；tb_lineno給出發(fā)生異常處的行號宣决；tb_lasti指的是精確的命令。在跟蹤對象中行號和最后一次指令可能與幀對象發(fā)生異常的行號不一致昏苏，如果該異常發(fā)生在try語句中尊沸，并且沒有匹配的except語句塊或finally語句塊威沫。

切片對象

切片對象代表__getitem__()方法中的切片。它們也可以通過內(nèi)建函數(shù)slice()創(chuàng)建洼专。

特殊的只讀屬性：start是前邊界棒掠；stop是后邊界；step是步值屁商；如果不提供值烟很，則為None。這些屬性可以是任意類型蜡镶。

切片對象支持一個(gè)方法：

slice.indices(self, length)

此方法有一個(gè)整型的參數(shù) length 并估算有關(guān)切片的信息雾袱，切片對象會(huì)描述是否應(yīng)用連續(xù)的 length 元素。該方法返回一個(gè)包含三個(gè)整型的元組帽哑；這三個(gè)整型分別代表start谜酒，stop和step或切片的步長。未提供或超出邊界的索引會(huì)按照符合正常切片的方法處理妻枕。

靜態(tài)方法對象

靜態(tài)方法對象提供了阻止上述將函數(shù)對象轉(zhuǎn)換為方法對象的方法僻族。靜態(tài)方法對象是一個(gè)對其他對象的包裝，通常是一個(gè)自定義方法對象屡谐。當(dāng)一個(gè)靜態(tài)方法對象被類或類實(shí)例檢索時(shí)述么，該對象實(shí)際上會(huì)返回一個(gè)包裝對象，這個(gè)包裝對象不會(huì)再做任何轉(zhuǎn)換愕掏。靜態(tài)方法對象本身是不可調(diào)用的度秘，但它們的包裝類是調(diào)用的。靜態(tài)方法對象通過內(nèi)建構(gòu)造器staticmethod()方法創(chuàng)建饵撑。

類方法對象

與靜態(tài)方法對象類似剑梳，類方法對象是一個(gè)其他對象的包裝，改變從類或類實(shí)例中檢索對象的方式滑潘。類對象的行為決定于“自定義方法”中描述的檢索方式垢乙。類方法對象通過內(nèi)建構(gòu)造器classmethod()創(chuàng)建。

譯者結(jié)語

翻譯真不是個(gè)好干的活语卤，真心累白反！但官方文檔真是寶啊粹舵，學(xué)到了很多東西钮孵，還需要慢慢消化理解。翻譯完后眼滤，有時(shí)間要做個(gè)總結(jié)文檔巴席。

限于譯者英文水平，如有翻譯不當(dāng)之處還請各位予以批評指正诅需。也希望感興趣的同學(xué)加入情妖，共同學(xué)習(xí)睬关，共同進(jìn)步。

PS：部分名詞中英對照：