### 導航
- [索引](../genindex.xhtml "總目錄")
- [模塊](../py-modindex.xhtml "Python 模塊索引") |
- [下一頁](compound_stmts.xhtml "8. 復合語句") |
- [上一頁](expressions.xhtml "6. 表達式") |
- 
- [Python](https://www.python.org/) ?
- zh\_CN 3.7.3 [文檔](../index.xhtml) ?
- [Python 語言參考](index.xhtml) ?
- $('.inline-search').show(0); |
# 7. 簡單語句
簡單語句由一個單獨的邏輯行構成。 多條簡單語句可以存在于同一行內并以分號分隔。 簡單語句的句法為:
```
simple_stmt ::= expression_stmt
| assert_stmt
| assignment_stmt
| augmented_assignment_stmt
| annotated_assignment_stmt
| pass_stmt
| del_stmt
| return_stmt
| yield_stmt
| raise_stmt
| break_stmt
| continue_stmt
| import_stmt
| future_stmt
| global_stmt
| nonlocal_stmt
```
## 7.1. 表達式語句
表達式語句用于計算和寫入值(大多是在交互模式下),或者(通常情況)調用一個過程 (過程就是不返回有意義結果的函數;在 Python 中,過程的返回值為 `None`)。 表達式語句的其他使用方式也是允許且有特定用處的。 表達式語句的句法為:
```
expression_stmt ::= starred_expression
```
表達式語句會對指定的表達式列表(也可能為單一表達式)進行求值。
在交互模式下,如果結果值不為 `None`,它會通過內置的 [`repr()`](../library/functions.xhtml#repr "repr") 函數轉換為一個字符串,該結果字符串將以單獨一行的形式寫入標準輸出(例外情況是如果結果為 `None`,則該過程調用不產生任何輸出。)
## 7.2. 賦值語句
賦值語句用于將名稱(重)綁定到特定值,以及修改屬性或可變對象的成員項:
```
assignment_stmt ::= (target_list "=")+ (starred_expression | yield_expression)
target_list ::= target ("," target)* [","]
target ::= identifier
| "(" [target_list] ")"
| "[" [target_list] "]"
| attributeref
| subscription
| slicing
| "*" target
```
(請參閱 [原型](expressions.xhtml#primaries) 一節了解 *屬性引用*, *抽取* 和 *切片* 的句法定義。)
賦值語句會對指定的表達式列表進行求值(注意這可能為單一表達式或是由逗號分隔的列表,后者將產生一個元組)并將單一結果對象從左至右逐個賦值給目標列表。
賦值是根據目標(列表)的格式遞歸地定義的。 當目標為一個可變對象(屬性引用、抽取或切片)的組成部分時,該可變對象必須最終執行賦值并決定其有效性,如果賦值操作不可接受也可能引發異常。 各種類型可用的規則和引發的異常通過對象類型的定義給出(參見 [標準類型層級結構](datamodel.xhtml#types) 一節)。
對象賦值的目標對象可以包含于圓括號或方括號內,具體操作按以下方式遞歸地定義。
- 如果目標列表為后面不帶逗號、可以包含于圓括號內的單一目標,則將對象賦值給該目標。
- 否則:該對象必須為具有與目標列表相同項數的可迭代對象,這些項將按從左至右的順序被賦值給對應的目標。
- 如果目標列表包含一個帶有星號前綴的目標,這稱為“加星”目標:則該對象至少必須為與目標列表項數減一相同項數的可迭代對象。 該可迭代對象前面的項將按從左至右的順序被賦值給加星目標之前的目標。 該可迭代對象末尾的項將被賦值給加星目標之后的目標。 然后該可迭代對象中剩余項的列表將被賦值給加星目標(該列表可以為空)。
- 否則:該對象必須為具有與目標列表相同項數的可迭代對象,這些項將按從左至右的順序被賦值給對應的目標。
對象賦值給單個目標的操作按以下方式遞歸地定義。
- 如果目標為標識符(名稱):
- 如果該名稱未出現于當前代碼塊的 [`global`](#global) 或 [`nonlocal`](#nonlocal) 語句中:該名稱將被綁定到當前局部命名空間的對象。
- 否則:該名稱將被分別綁定到全局命名空間或由 [`nonlocal`](#nonlocal) 所確定的外層命名空間的對象。
如果該名稱已經被綁定則將被重新綁定。 這可能導致之前被綁定到該名稱的對象的引用計數變為零,造成該對象進入釋放過程并調用其析構器(如果存在)。
- 如果該對象為屬性引用:引用中的原型表達式會被求值。 它應該產生一個具有可賦值屬性的對象;否則將引發 [`TypeError`](../library/exceptions.xhtml#TypeError "TypeError")。 該對象會被要求將可賦值對象賦值給指定的屬性;如果它無法執行賦值,則會引發異常 (通常應為 [`AttributeError`](../library/exceptions.xhtml#AttributeError "AttributeError") 但并不強制要求)。
注意:如果該對象為類實例并且屬性引用在賦值運算符的兩側都出現,則右側表達式 `a.x` 可以訪問實例屬性或(如果實例屬性不存在)類屬性。 左側目標 `a.x` 將總是設定為實例屬性,并在必要時創建該實例屬性。 因此,`a.x` 的兩次出現不一定指向相同的屬性:如果右側表達式指向一個類屬性,則左側表達式會創建一個新的實例屬性作為賦值的目標:
```
class Cls:
x = 3 # class variable
inst = Cls()
inst.x = inst.x + 1 # writes inst.x as 4 leaving Cls.x as 3
```
此描述不一定作用于描述器屬性,例如通過 [`property()`](../library/functions.xhtml#property "property") 創建的特征屬性。
- 如果目標為一個抽取項:引用中的原型表達式會被求值。 它應當產生一個可變序列對象(例如列表)或一個映射對象(例如字典)。 接下來,該抽取表達式會被求值。
如果原型為一個可變序列對象(例如列表),抽取應產生一個整數。 如其為負值,則再加上序列長度。 結果值必須為一個小于序列長度的非負整數,序列將把被賦值對象賦值給該整數指定索引號的項。 如果索引超出范圍,將會引發 [`IndexError`](../library/exceptions.xhtml#IndexError "IndexError") (給被抽取序列賦值不能向列表添加新項)。
如果原型為一個映射對象(例如字典),抽取必須具有與該映射的鍵類型相兼容的類型,然后映射中會創建一個將抽取映射到被賦值對象的鍵/值對。 這可以是替換一個現有鍵/值對并保持相同鍵值,也可以是插入一個新鍵/值對(如果具有相同值的鍵不存在)。
對于用戶定義對象,會調用 [`__setitem__()`](datamodel.xhtml#object.__setitem__ "object.__setitem__") 方法并附帶適當的參數。
- 如果目標為一個切片:性和痛苦的原型表達式會被求值。 它應當產生一個可變序列對象(例如列表)。 被賦值對象應當是一個相同類型的序列對象。 接下來,下界與上界表達式如果存在的話將被求值;默認值分別為零和序列長度。 上下邊界值應當為整數。 如果某一邊界為負值,則會加上序列長度。 求出的邊界會被裁剪至介于零和序列長度的開區間中。 最后,將要求序列對象以被賦值序列的項替換該切片。 切片的長度可能與被賦值序列的長度不同,這會在目標序列允許的情況下改變目標序列的長度。
**CPython implementation detail:** 在當前實現中,目標的句法被當作與表達式的句法相同,無效的句法會在代碼生成階段被拒絕,導致不太詳細的錯誤信息。
雖然賦值的定義意味著左手邊與右手邊的重疊是“同時”進行的(例如 `a, b = b, a` 會交換兩個變量的值),但在賦值給變量的多項集 *之內* 的重疊是從左至右進行的,這有時會令人混淆。 例如,以下程序將會打印出 `[0, 2]`:
```
x = [0, 1]
i = 0
i, x[i] = 1, 2 # i is updated, then x[i] is updated
print(x)
```
參見
[**PEP 3132**](https://www.python.org/dev/peps/pep-3132) \[https://www.python.org/dev/peps/pep-3132\] - 擴展的可迭代對象拆包對 `*target` 特性的規范說明。
### 7.2.1. 增強賦值語句
增強賦值語句就是在單個語句中將二元運算和賦值語句合為一體:
```
augmented_assignment_stmt ::= augtarget augop (expression_list | yield_expression)
augtarget ::= identifier | attributeref | subscription | slicing
augop ::= "+=" | "-=" | "*=" | "@=" | "/=" | "//=" | "%=" | "**="
| ">>=" | "<<=" | "&=" | "^=" | "|="
```
(請參閱 [原型](expressions.xhtml#primaries) 一節了解最后三種符號的句法定義。)
增強賦值語句將對目標和表達式列表求值(與普通賦值語句不同的是,前者不能為可迭代對象拆包),對兩個操作數相應類型的賦值執行指定的二元運算,并將結果賦值給原始目標。 目標僅會被求值一次。
增強賦值語句例如 `x += 1` 可以改寫為 `x = x + 1` 獲得類似但并非完全等價的效果。 在增強賦值的版本中,`x` 僅會被求值一次。 而且,在可能的情況下,實際的運算是 *原地* 執行的,也就是說并不是創建一個新對象并將其賦值給目標,而是直接修改原對象。
不同于普通賦值,增強賦值會在對右手邊求值 *之前* 對左手邊求值。 例如,`a[i] += f(x)` 首先查找 `a[i]`,然后對 `f(x)` 求值并執行加法操作,最后將結果寫回到 `a[i]`。
除了在單個語句中賦值給元組和多個目標的例外情況,增強賦值語句的賦值操作處理方式與普通賦值相同。 類似地,除了可能存在 *原地* 操作行為的例外情況,增強賦值語句執行的二元運算也與普通二元運算相同。
對于屬性引用類目標,針對常規賦值的 [關于類和實例屬性的警告](#attr-target-note) 也同樣適用。
### 7.2.2. 帶標注的賦值語句
[標注](../glossary.xhtml#term-variable-annotation) 賦值就是在單個語句中將變量或屬性標注和可選的賦值語句合為一體:
```
annotated_assignment_stmt ::= augtarget ":" expression ["=" expression]
```
與普通 [賦值語句](#assignment) 的差別在于僅有單個目標且僅有單個右手邊的值才被允許。
對于將簡單名稱作為賦值目標的情況,如果是在類或模塊作用域中,標注會被求值并存入一個特殊的類或模塊屬性 `__annotations__` 中,這是一個將變量名稱(如為私有會被移除)映射到被求值標注的字典。 此屬性為可寫并且在類或模塊體開始執行時如果靜態地發現標注就會自動創建。
對于將表達式作為賦值目標的情況,如果是在類或模塊作用域中,標注會被求值,但不會保存。
如果一個名稱在函數作用域內被標注,則該名稱為該作用域的局部變量。 標注絕不會在函數作用域內被求值和保存。
如果存在右手邊,帶標注的賦值會在對標注求值之前(如果適用)執行實際的賦值。 如果用作表達式目標的右手邊不存在,則解釋器會對目標求值,但最后的 [`__setitem__()`](datamodel.xhtml#object.__setitem__ "object.__setitem__") 或 [`__setattr__()`](datamodel.xhtml#object.__setattr__ "object.__setattr__") 調用除外。
參見
[**PEP 526**](https://www.python.org/dev/peps/pep-0526) \[https://www.python.org/dev/peps/pep-0526\] - 變量標注的語法該提議增加了標注變量(也包括類變量和實例變量)類型的語法,而不再是通過注釋來進行表達。
[**PEP 484**](https://www.python.org/dev/peps/pep-0484) \[https://www.python.org/dev/peps/pep-0484\] - 類型提示該提議增加了 [`typing`](../library/typing.xhtml#module-typing "typing: Support for type hints (see PEP 484).") 模塊以便為類型標注提供標準句法,可被靜態分析工具和 IDE 所使用。
## 7.3. `assert` 語句
assert 語句是在程序中插入調試性斷言的簡便方式:
```
assert_stmt ::= "assert" expression ["," expression]
```
簡單形式 `assert expression` 等價于
```
if __debug__:
if not expression: raise AssertionError
```
擴展形式 `assert expression1, expression2` 等價于
```
if __debug__:
if not expression1: raise AssertionError(expression2)
```
以上等價形式假定 [`__debug__`](../library/constants.xhtml#__debug__ "__debug__") 和 [`AssertionError`](../library/exceptions.xhtml#AssertionError "AssertionError") 指向具有指定名稱的內置變量。 在當前實現中,內置變量 [`__debug__`](../library/constants.xhtml#__debug__ "__debug__") 在正常情況下為 `True`,在請求優化時為 `False` (對應命令行選項為 [`-O`](../using/cmdline.xhtml#cmdoption-o))。 如果在編譯時請求優化,當前代碼生成器不會為 assert 語句發出任何代碼。 請注意不必在錯誤信息中包含失敗表達式的源代碼;它會被作為棧追蹤的一部分被顯示。
賦值給 [`__debug__`](../library/constants.xhtml#__debug__ "__debug__") 是非法的。 該內置變量的值會在解釋器啟動時確定。
## 7.4. `pass` 語句
```
pass_stmt ::= "pass"
```
[`pass`](#pass) 是一個空操作 --- 當它被執行時,什么都不發生。 它適合當語法上需要一條語句但并不需要執行任何代碼時用來臨時占位,例如:
```
def f(arg): pass # a function that does nothing (yet)
class C: pass # a class with no methods (yet)
```
## 7.5. `del` 語句
```
del_stmt ::= "del" target_list
```
刪除是遞歸定義的,與賦值的定義方式非常類似。 此處不再詳細說明,只給出一些提示。
目標列表的刪除將從左至右遞歸地刪除每一個目標。
名稱的刪除將從局部或全局命名空間中移除該名稱的綁定,具體作用域的確定是看該名稱是否有在同一代碼塊的 [`global`](#global) 語句中出現。 如果該名稱未被綁定,將會引發 [`NameError`](../library/exceptions.xhtml#NameError "NameError")。
屬性引用、抽取和切片的刪除會被傳遞給相應的原型對象;刪除一個切片基本等價于賦值為一個右側類型的空切片(但即便這一點也是由切片對象決定的)。
在 3.2 版更改: 在之前版本中,如果一個名稱作為被嵌套代碼塊中的自由變量出現,則將其從局部命名空間中刪除是非法的。
## 7.6. `return` 語句
```
return_stmt ::= "return" [expression_list]
```
[`return`](#return) 在語法上只會出現于函數定義所嵌套的代碼,不會出現于類定義所嵌套的代碼。
如果提供了表達式列表,它將被求值,否則以 `None` 替代。
[`return`](#return) 會離開當前函數調用,并以表達式列表 (或 `None`) 作為返回值。
當 [`return`](#return) 將控制流傳出一個帶有 [`finally`](compound_stmts.xhtml#finally) 子句的 [`try`](compound_stmts.xhtml#try) 語句時,該 `finally` 子句會先被執行然后再真正離開該函數。
在一個生成器函數中,[`return`](#return) 語句表示生成器已完成并將導致 [`StopIteration`](../library/exceptions.xhtml#StopIteration "StopIteration") 被引發。 返回值(如果有的話)會被當作一個參數用來構建 [`StopIteration`](../library/exceptions.xhtml#StopIteration "StopIteration") 并成為 `StopIteration.value` 屬性。
在一個異步生成器函數中,一個空的 [`return`](#return) 語句表示異步生成器已完成并將導致 [`StopAsyncIteration`](../library/exceptions.xhtml#StopAsyncIteration "StopAsyncIteration") 被引發。 一個非空的 `return` 語句在異步生成器函數中會導致語法錯誤。
## 7.7. `yield` 語句
```
yield_stmt ::= yield_expression
```
[`yield`](#yield) 語句在語義上等同于 [yield 表達式](expressions.xhtml#yieldexpr)。 yield 語句可用來省略在使用等效的 yield 表達式語句時所必須的圓括號。 例如,以下 yield 語句
```
yield <expr>
yield from <expr>
```
等同于以下 yield 表達式語句
```
(yield <expr>)
(yield from <expr>)
```
yield 表達式和語句僅在定義 [generator](../glossary.xhtml#term-generator) 函數時使用,并且僅被用于生成器函數的函數體內部。 在函數定義中使用 yield 就足以使得該定義創建的是生成器函數而非普通函數。
有關 [`yield`](#yield) 語義的完整細節請參看 [yield 表達式](expressions.xhtml#yieldexpr) 一節。
## 7.8. `raise` 語句
```
raise_stmt ::= "raise" [expression ["from" expression]]
```
如果不帶表達式,[`raise`](#raise) 會重新引發當前作用域內最后一個激活的異常。 如果當前作用域內沒有激活的異常,將會引發 [`RuntimeError`](../library/exceptions.xhtml#RuntimeError "RuntimeError") 來提示錯誤。
否則的話,[`raise`](#raise) 會將第一個表達式求值為異常對象。 它必須為 [`BaseException`](../library/exceptions.xhtml#BaseException "BaseException") 的子類或實例。 如果它是一個類,當需要時會通過不帶參數地實例化該類來獲得異常的實例。
異常的 *類型* 為異常實例的類,*值* 為實例本身。
當異常被引發時通常會自動創建一個回溯對象并將其關聯到可寫的 `__traceback__` 屬性。 你可以創建一個異常并同時使用 `with_traceback()` 異常方法(該方法將返回同一異常實例,并將回溯對象設為其參數)設置自己的回溯,就像這樣:
```
raise Exception("foo occurred").with_traceback(tracebackobj)
```
`from` 子句用于異常串連:如果有該子句,則第二個 *表達式* 必須為另一個異常或實例,它將作為可寫的 `__cause__` 屬性被關聯到所引發的異常。 如果引發的異常未被處理,兩個異常都將被打印出來:
```
>>> try:
... print(1 / 0)
... except Exception as exc:
... raise RuntimeError("Something bad happened") from exc
...
Traceback (most recent call last):
File "<stdin>", line 2, in <module>
ZeroDivisionError: division by zero
The above exception was the direct cause of the following exception:
Traceback (most recent call last):
File "<stdin>", line 4, in <module>
RuntimeError: Something bad happened
```
如果一個異常在異常處理器或 [`finally`](compound_stmts.xhtml#finally) clause: 中被引發,類似的機制會隱式地發揮作用,之前的異常將被關聯到新異常的 `__context__` 屬性:
```
>>> try:
... print(1 / 0)
... except:
... raise RuntimeError("Something bad happened")
...
Traceback (most recent call last):
File "<stdin>", line 2, in <module>
ZeroDivisionError: division by zero
During handling of the above exception, another exception occurred:
Traceback (most recent call last):
File "<stdin>", line 4, in <module>
RuntimeError: Something bad happened
```
異常串連可通過在 `from` 子句中指定 [`None`](../library/constants.xhtml#None "None") 來顯式地加以抑制:
```
>>> try:
... print(1 / 0)
... except:
... raise RuntimeError("Something bad happened") from None
...
Traceback (most recent call last):
File "<stdin>", line 4, in <module>
RuntimeError: Something bad happened
```
有關異常的更多信息可在 [異常](executionmodel.xhtml#exceptions) 一節查看,有關處理異常的信息可在 [try 語句](compound_stmts.xhtml#try) 一節查看。
在 3.3 版更改: [`None`](../library/constants.xhtml#None "None") 現在允許被用作 `raise X from Y` 中的 `Y`。
3\.3 新版功能: 使用 `__suppress_context__` 屬性來抑制異常上下文的自動顯示。
## 7.9. `break` 語句
```
break_stmt ::= "break"
```
[`break`](#break) 在語法上只會出現于 [`for`](compound_stmts.xhtml#for) 或 [`while`](compound_stmts.xhtml#while) 循環所嵌套的代碼,但不會出現于該循環內部的函數或類定義所嵌套的代碼。
它會終結最近的外層循環,如果循環有可選的 `else` 子句,也會跳過該子句。
如果一個 [`for`](compound_stmts.xhtml#for) 循環被 [`break`](#break) 所終結,該循環的控制目標會保持其當前值。
當 [`break`](#break) 將控制流傳出一個帶有 [`finally`](compound_stmts.xhtml#finally) 子句的 [`try`](compound_stmts.xhtml#try) 語句時,該 `finally` 子句會先被執行然后再真正離開該循環。
## 7.10. `continue` 語句
```
continue_stmt ::= "continue"
```
[`continue`](#continue) 在語法上只會出現于 [`for`](compound_stmts.xhtml#for) 或 [`while`](compound_stmts.xhtml#while) 循環所嵌套的代碼,但不會出現于該循環內部的函數或類定義或者 [`finally`](compound_stmts.xhtml#finally) 子句所嵌套的代碼。 它會繼續執行最近的外層循環的下一個輪次。
當 [`continue`](#continue) 將控制流傳出一個帶有 [`finally`](compound_stmts.xhtml#finally) 子句的 [`try`](compound_stmts.xhtml#try) 語句時,該 `finally` 子句會先被執行然后再真正開始循環的下一個輪次。
## 7.11. `import` 語句
```
import_stmt ::= "import" module ["as" identifier] ("," module ["as" identifier])*
| "from" relative_module "import" identifier ["as" identifier]
("," identifier ["as" identifier])*
| "from" relative_module "import" "(" identifier ["as" identifier]
("," identifier ["as" identifier])* [","] ")"
| "from" module "import" "*"
module ::= (identifier ".")* identifier
relative_module ::= "."* module | "."+
```
基本的 import 語句(不帶 [`from`](#from) 子句)會分兩步執行:
1. 查找一個模塊,如果有必要還會加載并初始化模塊。
2. 在局部命名空間中為 [`import`](#import) 語句發生位置所處的作用域定義一個或多個名稱。
當語句包含多個子句(由逗號分隔)時這兩個步驟將對每個子句分別執行,如同這些子句被分成獨立的 import 語句一樣。
第一個步驟即查找和加載模塊的詳情 [導入系統](import.xhtml#importsystem) 一節中有更詳細的描述,其中也描述了可被導入的多種類型的包和模塊,以及可用于定制導入系統的所有鉤子對象。 請注意這一步如果失敗,則可能說明模塊無法找到,*或者* 是在初始化模塊,包括執行模塊代碼期間發生了錯誤。
如果成功獲取到請求的模塊,則可以通過以下三種方式一之在局部命名空間中使用它:
- 如果模塊名稱之后帶有 `as`,則跟在 `as` 之后的名稱將直接綁定到所導入的模塊。
- 如果沒有指定其他名稱,且被導入的模塊為最高層級模塊,則模塊的名稱將被綁定到局部命名空間作為對所導入模塊的引用。
- 如果被導入的模塊 *不是* 最高層級模塊,則包含該模塊的最高層級包的名稱將被綁定到局部命名空間作為對該最高層級包的引用。 所導入的模塊必須使用其完整限定名稱來訪問而不能直接訪問。
[`from`](#from) 形式使用的過程略微繁復一些:
1. 查找 [`from`](#from) 子句中指定的模塊,如有必要還會加載并初始化模塊;
2. 對于 [`import`](#import) 子句中指定的每個標識符:
1. 檢查被導入模塊是否有該名稱的屬性
2. 如果沒有,嘗試導入具有該名稱的子模塊,然后再次檢查被導入模塊是否有該屬性
3. 如果未找到該屬性,則引發 [`ImportError`](../library/exceptions.xhtml#ImportError "ImportError")。
4. 否則的話,將對該值的引用存入局部命名空間,如果有 `as` 子句則使用其指定的名稱,否則使用該屬性的名稱
例如:
```
import foo # foo imported and bound locally
import foo.bar.baz # foo.bar.baz imported, foo bound locally
import foo.bar.baz as fbb # foo.bar.baz imported and bound as fbb
from foo.bar import baz # foo.bar.baz imported and bound as baz
from foo import attr # foo imported and foo.attr bound as attr
```
如果標識符列表改為一個星號 (`'*'`),則在模塊中定義的全部公有名稱都將按 [`import`](#import) 語句所在的作用域被綁定到局部命名空間。
一個模塊所定義的 *公有名稱* 是由在模塊的命名空間中檢測一個名為 `__all__` 的變量來確定的;如果有定義,它必須是一個字符串列表,其中的項為該模塊所定義或導入的名稱。 在 `__all__` 中所給出的名稱都會被視為公有并且應當存在。 如果 `__all__` 沒有被定義,則公有名稱的集合將包含在模塊的命名空間中找到的所有不以下劃線字符 (`'_'`) 打頭的名稱。 `__all__` 應當包括整個公有 API。 它的目標是避免意外地導出不屬于 API 的一部分的項(例如在模塊內部被導入和使用的庫模塊)。
通配符形式的導入 --- `from module import *` --- 僅在模塊層級上被允許。 嘗試在類或函數定義中使用它將引發 [`SyntaxError`](../library/exceptions.xhtml#SyntaxError "SyntaxError")。
當指定要導入哪個模塊時,你不必指定模塊的絕對名稱。 當一個模塊或包被包含在另一個包之中時,可以在同一個最高層級包中進行相對導入,而不必提及包名稱。 通過在 [`from`](#from) 之后指定的模塊或包中使用前綴點號,你可以在不指定確切名稱的情況下指明在當前包層級結構中要上溯多少級。 一個前綴點號表示是執行導入的模塊所在的當前包,兩個點號表示上溯一個包層級。 三個點號表示上溯兩級,依此類推。 因此如果你執行 `from . import mod` 時所處位置為 `pkg` 包內的一個模塊,則最終你將導入 `pkg.mod`。 如果你執行 `from ..subpkg2 import mod` 時所處位置為 `pkg.subpkg1` 則你將導入 `pkg.subpkg2.mod`。 有關相對導入的規范說明包含在 [Package Relative Imports](import.xhtml#relativeimports) 一節中。
[`importlib.import_module()`](../library/importlib.xhtml#importlib.import_module "importlib.import_module") 被提供用來為動態地確定要導入模塊的應用提供支持。
### 7.11.1. future 語句
*future 語句* 是一種針對編譯器的指令,指明某個特定模塊應當使用在特定的未來某個 Python 發行版中成為標準特性的語法或語義。
future 語句的目的是使得向在語言中引入了不兼容改變的 Python 未來版本的遷移更為容易。 它允許基于每個模塊在某種新特性成為標準之前的發行版中使用該特性。
```
future_stmt ::= "from" "__future__" "import" feature ["as" identifier]
("," feature ["as" identifier])*
| "from" "__future__" "import" "(" feature ["as" identifier]
("," feature ["as" identifier])* [","] ")"
feature ::= identifier
```
future 語句必須在靠近模塊開頭的位置出現。 可以出現在 future 語句之前行只有:
- 模塊的文檔字符串(如果存在),
- 注釋,
- 空行,以及
- 其他 future 語句。
在 Python 3.7 中唯一需要使用 future 語句的特性是 `標注`。
future 語句所啟用的所有歷史特性仍然為 Python 3 所認可。 其中包括 `absolute_import`, `division`, `generators`, `generator_stop`, `unicode_literals`, `print_function`, `nested_scopes` 和 `with_statement`。 它們都已成為冗余項,因為它們總是為已啟用狀態,保留它們只是為了向后兼容。
future 語句在編譯時會被識別并做特殊對待:對核心構造語義的改變常常是通過生成不同的代碼來實現。 新的特性甚至可能會引入新的不兼容語法(例如新的保留字),在這種情況下編譯器可能需要以不同的方式來解析模塊。 這樣的決定不能推遲到運行時方才作出。
對于任何給定的發布版本,編譯器要知道哪些特性名稱已被定義,如果某個 future 語句包含未知的特性則會引發編譯時錯誤。
直接運行時的語義與任何 import 語句相同:存在一個后文將詳細說明的標準模塊 [`__future__`](../library/__future__.xhtml#module-__future__ "__future__: Future statement definitions"),它會在執行 future 語句時以通常的方式被導入。
相應的運行時語義取決于 future 語句所啟用的指定特性。
請注意以下語句沒有任何特別之處:
```
import __future__ [as name]
```
這并非 future 語句;它只是一條沒有特殊語義或語法限制的普通 import 語句。
在默認情況下,通過對Code compiled by calls to the 內置函數 [`exec()`](../library/functions.xhtml#exec "exec") 和 [`compile()`](../library/functions.xhtml#compile "compile") 的調用所編譯的代碼如果出現于一個包含有 future 語句的模塊 `M` 之中,就會使用 future 語句所關聯的語法和語義。 此行為可以通過 [`compile()`](../library/functions.xhtml#compile "compile") 的可選參數加以控制 --- 請參閱該函數的文檔以了解詳情。
在交互式解釋器提示符中鍵入的 future 語句將在解釋器會話此后的交互中有效。 如果一個解釋器的啟動使用了 [`-i`](../using/cmdline.xhtml#cmdoption-i) 選項啟動,并傳入了一個腳本名稱來執行,且該腳本包含 future 語句,它將在交互式會話開始執行腳本之后保持有效。
參見
[**PEP 236**](https://www.python.org/dev/peps/pep-0236) \[https://www.python.org/dev/peps/pep-0236\] - 回到 \_\_future\_\_有關 \_\_future\_\_ 機制的最初提議。
## 7.12. `global` 語句
```
global_stmt ::= "global" identifier ("," identifier)*
```
[`global`](#global) 語句是作用于整個當前代碼塊的聲明。 它意味著所列出的標識符將被解讀為全局變量。 要給全局變量賦值不可能不用到 `global` 關鍵字,不過自由變量也可以指向全局變量而不必聲明為全局變量。
在 [`global`](#global) 語句中列出的名稱不得在同一代碼塊內該 `global` 語句之前的位置中使用。
在 [`global`](#global) 語句中列出的名稱不得被定義為正式形參,不也得出現于 [`for`](compound_stmts.xhtml#for) 循環的控制目標、[`class`](compound_stmts.xhtml#class) 定義、函數定義、[`import`](#import) 語句或變量標注之中。
**CPython implementation detail:** 當前的實現并未強制要求所有的上述限制,但程序不應當濫用這樣的自由,因為未來的實現可能會改為強制要求,并靜默地改變程序的含義。
**程序員注意事項:** [`global`](#global) 是對解析器的指令。 它僅對與 `global` 語句同時被解析的代碼起作用。 特別地,包含在提供給內置 [`exec()`](../library/functions.xhtml#exec "exec") 函數字符串或代碼對象中的 `global` 語句并不會影響 *包含* 該函數調用的代碼塊,而包含在這種字符串中的代碼也不會受到包含該函數調用的代碼中的 `global` 語句影響。 這同樣適用于 [`eval()`](../library/functions.xhtml#eval "eval") 和 [`compile()`](../library/functions.xhtml#compile "compile") 函數。
## 7.13. `nonlocal` 語句
```
nonlocal_stmt ::= "nonlocal" identifier ("," identifier)*
```
[`nonlocal`](#nonlocal) 語句會使得所列出的名稱指向之前在最近的包含作用域中綁定的除全局變量以外的變量。 這種功能很重要,因為綁定的默認行為是先搜索局部命名空間。 這個語句允許被封裝的代碼重新綁定局部作用域以外且非全局(模塊)作用域當中的變量。
與 [`global`](#global) 語句中列出的名稱不同,[`nonlocal`](#nonlocal) 語句中列出的名稱必須指向之前存在于包含作用域之中的綁定(在這個應當用來創建新綁定的作用域不能被無歧義地確定)。
[`nonlocal`](#nonlocal) 語句中列出的名稱不得與之前存在于局部作用域中的綁定相沖突。
參見
[**PEP 3104**](https://www.python.org/dev/peps/pep-3104) \[https://www.python.org/dev/peps/pep-3104\] - 訪問外層作用域中的名稱有關 [`nonlocal`](#nonlocal) 語句的規范說明。
### 導航
- [索引](../genindex.xhtml "總目錄")
- [模塊](../py-modindex.xhtml "Python 模塊索引") |
- [下一頁](compound_stmts.xhtml "8. 復合語句") |
- [上一頁](expressions.xhtml "6. 表達式") |
- 
- [Python](https://www.python.org/) ?
- zh\_CN 3.7.3 [文檔](../index.xhtml) ?
- [Python 語言參考](index.xhtml) ?
- $('.inline-search').show(0); |
? [版權所有](../copyright.xhtml) 2001-2019, Python Software Foundation.
Python 軟件基金會是一個非盈利組織。 [請捐助。](https://www.python.org/psf/donations/)
最后更新于 5月 21, 2019. [發現了問題](../bugs.xhtml)?
使用[Sphinx](http://sphinx.pocoo.org/)1.8.4 創建。
- Python文檔內容
- Python 有什么新變化?
- Python 3.7 有什么新變化
- 摘要 - 發布重點
- 新的特性
- 其他語言特性修改
- 新增模塊
- 改進的模塊
- C API 的改變
- 構建的改變
- 性能優化
- 其他 CPython 實現的改變
- 已棄用的 Python 行為
- 已棄用的 Python 模塊、函數和方法
- 已棄用的 C API 函數和類型
- 平臺支持的移除
- API 與特性的移除
- 移除的模塊
- Windows 專屬的改變
- 移植到 Python 3.7
- Python 3.7.1 中的重要變化
- Python 3.7.2 中的重要變化
- Python 3.6 有什么新變化A
- 摘要 - 發布重點
- 新的特性
- 其他語言特性修改
- 新增模塊
- 改進的模塊
- 性能優化
- Build and C API Changes
- 其他改進
- 棄用
- 移除
- 移植到Python 3.6
- Python 3.6.2 中的重要變化
- Python 3.6.4 中的重要變化
- Python 3.6.5 中的重要變化
- Python 3.6.7 中的重要變化
- Python 3.5 有什么新變化
- 摘要 - 發布重點
- 新的特性
- 其他語言特性修改
- 新增模塊
- 改進的模塊
- Other module-level changes
- 性能優化
- Build and C API Changes
- 棄用
- 移除
- Porting to Python 3.5
- Notable changes in Python 3.5.4
- What's New In Python 3.4
- 摘要 - 發布重點
- 新的特性
- 新增模塊
- 改進的模塊
- CPython Implementation Changes
- 棄用
- 移除
- Porting to Python 3.4
- Changed in 3.4.3
- What's New In Python 3.3
- 摘要 - 發布重點
- PEP 405: Virtual Environments
- PEP 420: Implicit Namespace Packages
- PEP 3118: New memoryview implementation and buffer protocol documentation
- PEP 393: Flexible String Representation
- PEP 397: Python Launcher for Windows
- PEP 3151: Reworking the OS and IO exception hierarchy
- PEP 380: Syntax for Delegating to a Subgenerator
- PEP 409: Suppressing exception context
- PEP 414: Explicit Unicode literals
- PEP 3155: Qualified name for classes and functions
- PEP 412: Key-Sharing Dictionary
- PEP 362: Function Signature Object
- PEP 421: Adding sys.implementation
- Using importlib as the Implementation of Import
- 其他語言特性修改
- A Finer-Grained Import Lock
- Builtin functions and types
- 新增模塊
- 改進的模塊
- 性能優化
- Build and C API Changes
- 棄用
- Porting to Python 3.3
- What's New In Python 3.2
- PEP 384: Defining a Stable ABI
- PEP 389: Argparse Command Line Parsing Module
- PEP 391: Dictionary Based Configuration for Logging
- PEP 3148: The concurrent.futures module
- PEP 3147: PYC Repository Directories
- PEP 3149: ABI Version Tagged .so Files
- PEP 3333: Python Web Server Gateway Interface v1.0.1
- 其他語言特性修改
- New, Improved, and Deprecated Modules
- 多線程
- 性能優化
- Unicode
- Codecs
- 文檔
- IDLE
- Code Repository
- Build and C API Changes
- Porting to Python 3.2
- What's New In Python 3.1
- PEP 372: Ordered Dictionaries
- PEP 378: Format Specifier for Thousands Separator
- 其他語言特性修改
- New, Improved, and Deprecated Modules
- 性能優化
- IDLE
- Build and C API Changes
- Porting to Python 3.1
- What's New In Python 3.0
- Common Stumbling Blocks
- Overview Of Syntax Changes
- Changes Already Present In Python 2.6
- Library Changes
- PEP 3101: A New Approach To String Formatting
- Changes To Exceptions
- Miscellaneous Other Changes
- Build and C API Changes
- 性能
- Porting To Python 3.0
- What's New in Python 2.7
- The Future for Python 2.x
- Changes to the Handling of Deprecation Warnings
- Python 3.1 Features
- PEP 372: Adding an Ordered Dictionary to collections
- PEP 378: Format Specifier for Thousands Separator
- PEP 389: The argparse Module for Parsing Command Lines
- PEP 391: Dictionary-Based Configuration For Logging
- PEP 3106: Dictionary Views
- PEP 3137: The memoryview Object
- 其他語言特性修改
- New and Improved Modules
- Build and C API Changes
- Other Changes and Fixes
- Porting to Python 2.7
- New Features Added to Python 2.7 Maintenance Releases
- Acknowledgements
- Python 2.6 有什么新變化
- Python 3.0
- Changes to the Development Process
- PEP 343: The 'with' statement
- PEP 366: Explicit Relative Imports From a Main Module
- PEP 370: Per-user site-packages Directory
- PEP 371: The multiprocessing Package
- PEP 3101: Advanced String Formatting
- PEP 3105: print As a Function
- PEP 3110: Exception-Handling Changes
- PEP 3112: Byte Literals
- PEP 3116: New I/O Library
- PEP 3118: Revised Buffer Protocol
- PEP 3119: Abstract Base Classes
- PEP 3127: Integer Literal Support and Syntax
- PEP 3129: Class Decorators
- PEP 3141: A Type Hierarchy for Numbers
- 其他語言特性修改
- New and Improved Modules
- Deprecations and Removals
- Build and C API Changes
- Porting to Python 2.6
- Acknowledgements
- What's New in Python 2.5
- PEP 308: Conditional Expressions
- PEP 309: Partial Function Application
- PEP 314: Metadata for Python Software Packages v1.1
- PEP 328: Absolute and Relative Imports
- PEP 338: Executing Modules as Scripts
- PEP 341: Unified try/except/finally
- PEP 342: New Generator Features
- PEP 343: The 'with' statement
- PEP 352: Exceptions as New-Style Classes
- PEP 353: Using ssize_t as the index type
- PEP 357: The 'index' method
- 其他語言特性修改
- New, Improved, and Removed Modules
- Build and C API Changes
- Porting to Python 2.5
- Acknowledgements
- What's New in Python 2.4
- PEP 218: Built-In Set Objects
- PEP 237: Unifying Long Integers and Integers
- PEP 289: Generator Expressions
- PEP 292: Simpler String Substitutions
- PEP 318: Decorators for Functions and Methods
- PEP 322: Reverse Iteration
- PEP 324: New subprocess Module
- PEP 327: Decimal Data Type
- PEP 328: Multi-line Imports
- PEP 331: Locale-Independent Float/String Conversions
- 其他語言特性修改
- New, Improved, and Deprecated Modules
- Build and C API Changes
- Porting to Python 2.4
- Acknowledgements
- What's New in Python 2.3
- PEP 218: A Standard Set Datatype
- PEP 255: Simple Generators
- PEP 263: Source Code Encodings
- PEP 273: Importing Modules from ZIP Archives
- PEP 277: Unicode file name support for Windows NT
- PEP 278: Universal Newline Support
- PEP 279: enumerate()
- PEP 282: The logging Package
- PEP 285: A Boolean Type
- PEP 293: Codec Error Handling Callbacks
- PEP 301: Package Index and Metadata for Distutils
- PEP 302: New Import Hooks
- PEP 305: Comma-separated Files
- PEP 307: Pickle Enhancements
- Extended Slices
- 其他語言特性修改
- New, Improved, and Deprecated Modules
- Pymalloc: A Specialized Object Allocator
- Build and C API Changes
- Other Changes and Fixes
- Porting to Python 2.3
- Acknowledgements
- What's New in Python 2.2
- 概述
- PEPs 252 and 253: Type and Class Changes
- PEP 234: Iterators
- PEP 255: Simple Generators
- PEP 237: Unifying Long Integers and Integers
- PEP 238: Changing the Division Operator
- Unicode Changes
- PEP 227: Nested Scopes
- New and Improved Modules
- Interpreter Changes and Fixes
- Other Changes and Fixes
- Acknowledgements
- What's New in Python 2.1
- 概述
- PEP 227: Nested Scopes
- PEP 236: future Directives
- PEP 207: Rich Comparisons
- PEP 230: Warning Framework
- PEP 229: New Build System
- PEP 205: Weak References
- PEP 232: Function Attributes
- PEP 235: Importing Modules on Case-Insensitive Platforms
- PEP 217: Interactive Display Hook
- PEP 208: New Coercion Model
- PEP 241: Metadata in Python Packages
- New and Improved Modules
- Other Changes and Fixes
- Acknowledgements
- What's New in Python 2.0
- 概述
- What About Python 1.6?
- New Development Process
- Unicode
- 列表推導式
- Augmented Assignment
- 字符串的方法
- Garbage Collection of Cycles
- Other Core Changes
- Porting to 2.0
- Extending/Embedding Changes
- Distutils: Making Modules Easy to Install
- XML Modules
- Module changes
- New modules
- IDLE Improvements
- Deleted and Deprecated Modules
- Acknowledgements
- 更新日志
- Python 下一版
- Python 3.7.3 最終版
- Python 3.7.3 發布候選版 1
- Python 3.7.2 最終版
- Python 3.7.2 發布候選版 1
- Python 3.7.1 最終版
- Python 3.7.1 RC 2版本
- Python 3.7.1 發布候選版 1
- Python 3.7.0 正式版
- Python 3.7.0 release candidate 1
- Python 3.7.0 beta 5
- Python 3.7.0 beta 4
- Python 3.7.0 beta 3
- Python 3.7.0 beta 2
- Python 3.7.0 beta 1
- Python 3.7.0 alpha 4
- Python 3.7.0 alpha 3
- Python 3.7.0 alpha 2
- Python 3.7.0 alpha 1
- Python 3.6.6 final
- Python 3.6.6 RC 1
- Python 3.6.5 final
- Python 3.6.5 release candidate 1
- Python 3.6.4 final
- Python 3.6.4 release candidate 1
- Python 3.6.3 final
- Python 3.6.3 release candidate 1
- Python 3.6.2 final
- Python 3.6.2 release candidate 2
- Python 3.6.2 release candidate 1
- Python 3.6.1 final
- Python 3.6.1 release candidate 1
- Python 3.6.0 final
- Python 3.6.0 release candidate 2
- Python 3.6.0 release candidate 1
- Python 3.6.0 beta 4
- Python 3.6.0 beta 3
- Python 3.6.0 beta 2
- Python 3.6.0 beta 1
- Python 3.6.0 alpha 4
- Python 3.6.0 alpha 3
- Python 3.6.0 alpha 2
- Python 3.6.0 alpha 1
- Python 3.5.5 final
- Python 3.5.5 release candidate 1
- Python 3.5.4 final
- Python 3.5.4 release candidate 1
- Python 3.5.3 final
- Python 3.5.3 release candidate 1
- Python 3.5.2 final
- Python 3.5.2 release candidate 1
- Python 3.5.1 final
- Python 3.5.1 release candidate 1
- Python 3.5.0 final
- Python 3.5.0 release candidate 4
- Python 3.5.0 release candidate 3
- Python 3.5.0 release candidate 2
- Python 3.5.0 release candidate 1
- Python 3.5.0 beta 4
- Python 3.5.0 beta 3
- Python 3.5.0 beta 2
- Python 3.5.0 beta 1
- Python 3.5.0 alpha 4
- Python 3.5.0 alpha 3
- Python 3.5.0 alpha 2
- Python 3.5.0 alpha 1
- Python 教程
- 課前甜點
- 使用 Python 解釋器
- 調用解釋器
- 解釋器的運行環境
- Python 的非正式介紹
- Python 作為計算器使用
- 走向編程的第一步
- 其他流程控制工具
- if 語句
- for 語句
- range() 函數
- break 和 continue 語句,以及循環中的 else 子句
- pass 語句
- 定義函數
- 函數定義的更多形式
- 小插曲:編碼風格
- 數據結構
- 列表的更多特性
- del 語句
- 元組和序列
- 集合
- 字典
- 循環的技巧
- 深入條件控制
- 序列和其它類型的比較
- 模塊
- 有關模塊的更多信息
- 標準模塊
- dir() 函數
- 包
- 輸入輸出
- 更漂亮的輸出格式
- 讀寫文件
- 錯誤和異常
- 語法錯誤
- 異常
- 處理異常
- 拋出異常
- 用戶自定義異常
- 定義清理操作
- 預定義的清理操作
- 類
- 名稱和對象
- Python 作用域和命名空間
- 初探類
- 補充說明
- 繼承
- 私有變量
- 雜項說明
- 迭代器
- 生成器
- 生成器表達式
- 標準庫簡介
- 操作系統接口
- 文件通配符
- 命令行參數
- 錯誤輸出重定向和程序終止
- 字符串模式匹配
- 數學
- 互聯網訪問
- 日期和時間
- 數據壓縮
- 性能測量
- 質量控制
- 自帶電池
- 標準庫簡介 —— 第二部分
- 格式化輸出
- 模板
- 使用二進制數據記錄格式
- 多線程
- 日志
- 弱引用
- 用于操作列表的工具
- 十進制浮點運算
- 虛擬環境和包
- 概述
- 創建虛擬環境
- 使用pip管理包
- 接下來?
- 交互式編輯和編輯歷史
- Tab 補全和編輯歷史
- 默認交互式解釋器的替代品
- 浮點算術:爭議和限制
- 表示性錯誤
- 附錄
- 交互模式
- 安裝和使用 Python
- 命令行與環境
- 命令行
- 環境變量
- 在Unix平臺中使用Python
- 獲取最新版本的Python
- 構建Python
- 與Python相關的路徑和文件
- 雜項
- 編輯器和集成開發環境
- 在Windows上使用 Python
- 完整安裝程序
- Microsoft Store包
- nuget.org 安裝包
- 可嵌入的包
- 替代捆綁包
- 配置Python
- 適用于Windows的Python啟動器
- 查找模塊
- 附加模塊
- 在Windows上編譯Python
- 其他平臺
- 在蘋果系統上使用 Python
- 獲取和安裝 MacPython
- IDE
- 安裝額外的 Python 包
- Mac 上的圖形界面編程
- 在 Mac 上分發 Python 應用程序
- 其他資源
- Python 語言參考
- 概述
- 其他實現
- 標注
- 詞法分析
- 行結構
- 其他形符
- 標識符和關鍵字
- 字面值
- 運算符
- 分隔符
- 數據模型
- 對象、值與類型
- 標準類型層級結構
- 特殊方法名稱
- 協程
- 執行模型
- 程序的結構
- 命名與綁定
- 異常
- 導入系統
- importlib
- 包
- 搜索
- 加載
- 基于路徑的查找器
- 替換標準導入系統
- Package Relative Imports
- 有關 main 的特殊事項
- 開放問題項
- 參考文獻
- 表達式
- 算術轉換
- 原子
- 原型
- await 表達式
- 冪運算符
- 一元算術和位運算
- 二元算術運算符
- 移位運算
- 二元位運算
- 比較運算
- 布爾運算
- 條件表達式
- lambda 表達式
- 表達式列表
- 求值順序
- 運算符優先級
- 簡單語句
- 表達式語句
- 賦值語句
- assert 語句
- pass 語句
- del 語句
- return 語句
- yield 語句
- raise 語句
- break 語句
- continue 語句
- import 語句
- global 語句
- nonlocal 語句
- 復合語句
- if 語句
- while 語句
- for 語句
- try 語句
- with 語句
- 函數定義
- 類定義
- 協程
- 最高層級組件
- 完整的 Python 程序
- 文件輸入
- 交互式輸入
- 表達式輸入
- 完整的語法規范
- Python 標準庫
- 概述
- 可用性注釋
- 內置函數
- 內置常量
- 由 site 模塊添加的常量
- 內置類型
- 邏輯值檢測
- 布爾運算 — and, or, not
- 比較
- 數字類型 — int, float, complex
- 迭代器類型
- 序列類型 — list, tuple, range
- 文本序列類型 — str
- 二進制序列類型 — bytes, bytearray, memoryview
- 集合類型 — set, frozenset
- 映射類型 — dict
- 上下文管理器類型
- 其他內置類型
- 特殊屬性
- 內置異常
- 基類
- 具體異常
- 警告
- 異常層次結構
- 文本處理服務
- string — 常見的字符串操作
- re — 正則表達式操作
- 模塊 difflib 是一個計算差異的助手
- textwrap — Text wrapping and filling
- unicodedata — Unicode 數據庫
- stringprep — Internet String Preparation
- readline — GNU readline interface
- rlcompleter — GNU readline的完成函數
- 二進制數據服務
- struct — Interpret bytes as packed binary data
- codecs — Codec registry and base classes
- 數據類型
- datetime — 基礎日期/時間數據類型
- calendar — General calendar-related functions
- collections — 容器數據類型
- collections.abc — 容器的抽象基類
- heapq — 堆隊列算法
- bisect — Array bisection algorithm
- array — Efficient arrays of numeric values
- weakref — 弱引用
- types — Dynamic type creation and names for built-in types
- copy — 淺層 (shallow) 和深層 (deep) 復制操作
- pprint — 數據美化輸出
- reprlib — Alternate repr() implementation
- enum — Support for enumerations
- 數字和數學模塊
- numbers — 數字的抽象基類
- math — 數學函數
- cmath — Mathematical functions for complex numbers
- decimal — 十進制定點和浮點運算
- fractions — 分數
- random — 生成偽隨機數
- statistics — Mathematical statistics functions
- 函數式編程模塊
- itertools — 為高效循環而創建迭代器的函數
- functools — 高階函數和可調用對象上的操作
- operator — 標準運算符替代函數
- 文件和目錄訪問
- pathlib — 面向對象的文件系統路徑
- os.path — 常見路徑操作
- fileinput — Iterate over lines from multiple input streams
- stat — Interpreting stat() results
- filecmp — File and Directory Comparisons
- tempfile — Generate temporary files and directories
- glob — Unix style pathname pattern expansion
- fnmatch — Unix filename pattern matching
- linecache — Random access to text lines
- shutil — High-level file operations
- macpath — Mac OS 9 路徑操作函數
- 數據持久化
- pickle —— Python 對象序列化
- copyreg — Register pickle support functions
- shelve — Python object persistence
- marshal — Internal Python object serialization
- dbm — Interfaces to Unix “databases”
- sqlite3 — SQLite 數據庫 DB-API 2.0 接口模塊
- 數據壓縮和存檔
- zlib — 與 gzip 兼容的壓縮
- gzip — 對 gzip 格式的支持
- bz2 — 對 bzip2 壓縮算法的支持
- lzma — 用 LZMA 算法壓縮
- zipfile — 在 ZIP 歸檔中工作
- tarfile — Read and write tar archive files
- 文件格式
- csv — CSV 文件讀寫
- configparser — Configuration file parser
- netrc — netrc file processing
- xdrlib — Encode and decode XDR data
- plistlib — Generate and parse Mac OS X .plist files
- 加密服務
- hashlib — 安全哈希與消息摘要
- hmac — 基于密鑰的消息驗證
- secrets — Generate secure random numbers for managing secrets
- 通用操作系統服務
- os — 操作系統接口模塊
- io — 處理流的核心工具
- time — 時間的訪問和轉換
- argparse — 命令行選項、參數和子命令解析器
- getopt — C-style parser for command line options
- 模塊 logging — Python 的日志記錄工具
- logging.config — 日志記錄配置
- logging.handlers — Logging handlers
- getpass — 便攜式密碼輸入工具
- curses — 終端字符單元顯示的處理
- curses.textpad — Text input widget for curses programs
- curses.ascii — Utilities for ASCII characters
- curses.panel — A panel stack extension for curses
- platform — Access to underlying platform's identifying data
- errno — Standard errno system symbols
- ctypes — Python 的外部函數庫
- 并發執行
- threading — 基于線程的并行
- multiprocessing — 基于進程的并行
- concurrent 包
- concurrent.futures — 啟動并行任務
- subprocess — 子進程管理
- sched — 事件調度器
- queue — 一個同步的隊列類
- _thread — 底層多線程 API
- _dummy_thread — _thread 的替代模塊
- dummy_threading — 可直接替代 threading 模塊。
- contextvars — Context Variables
- Context Variables
- Manual Context Management
- asyncio support
- 網絡和進程間通信
- asyncio — 異步 I/O
- socket — 底層網絡接口
- ssl — TLS/SSL wrapper for socket objects
- select — Waiting for I/O completion
- selectors — 高級 I/O 復用庫
- asyncore — 異步socket處理器
- asynchat — 異步 socket 指令/響應 處理器
- signal — Set handlers for asynchronous events
- mmap — Memory-mapped file support
- 互聯網數據處理
- email — 電子郵件與 MIME 處理包
- json — JSON 編碼和解碼器
- mailcap — Mailcap file handling
- mailbox — Manipulate mailboxes in various formats
- mimetypes — Map filenames to MIME types
- base64 — Base16, Base32, Base64, Base85 數據編碼
- binhex — 對binhex4文件進行編碼和解碼
- binascii — 二進制和 ASCII 碼互轉
- quopri — Encode and decode MIME quoted-printable data
- uu — Encode and decode uuencode files
- 結構化標記處理工具
- html — 超文本標記語言支持
- html.parser — 簡單的 HTML 和 XHTML 解析器
- html.entities — HTML 一般實體的定義
- XML處理模塊
- xml.etree.ElementTree — The ElementTree XML API
- xml.dom — The Document Object Model API
- xml.dom.minidom — Minimal DOM implementation
- xml.dom.pulldom — Support for building partial DOM trees
- xml.sax — Support for SAX2 parsers
- xml.sax.handler — Base classes for SAX handlers
- xml.sax.saxutils — SAX Utilities
- xml.sax.xmlreader — Interface for XML parsers
- xml.parsers.expat — Fast XML parsing using Expat
- 互聯網協議和支持
- webbrowser — 方便的Web瀏覽器控制器
- cgi — Common Gateway Interface support
- cgitb — Traceback manager for CGI scripts
- wsgiref — WSGI Utilities and Reference Implementation
- urllib — URL 處理模塊
- urllib.request — 用于打開 URL 的可擴展庫
- urllib.response — Response classes used by urllib
- urllib.parse — Parse URLs into components
- urllib.error — Exception classes raised by urllib.request
- urllib.robotparser — Parser for robots.txt
- http — HTTP 模塊
- http.client — HTTP協議客戶端
- ftplib — FTP protocol client
- poplib — POP3 protocol client
- imaplib — IMAP4 protocol client
- nntplib — NNTP protocol client
- smtplib —SMTP協議客戶端
- smtpd — SMTP Server
- telnetlib — Telnet client
- uuid — UUID objects according to RFC 4122
- socketserver — A framework for network servers
- http.server — HTTP 服務器
- http.cookies — HTTP state management
- http.cookiejar — Cookie handling for HTTP clients
- xmlrpc — XMLRPC 服務端與客戶端模塊
- xmlrpc.client — XML-RPC client access
- xmlrpc.server — Basic XML-RPC servers
- ipaddress — IPv4/IPv6 manipulation library
- 多媒體服務
- audioop — Manipulate raw audio data
- aifc — Read and write AIFF and AIFC files
- sunau — 讀寫 Sun AU 文件
- wave — 讀寫WAV格式文件
- chunk — Read IFF chunked data
- colorsys — Conversions between color systems
- imghdr — 推測圖像類型
- sndhdr — 推測聲音文件的類型
- ossaudiodev — Access to OSS-compatible audio devices
- 國際化
- gettext — 多語種國際化服務
- locale — 國際化服務
- 程序框架
- turtle — 海龜繪圖
- cmd — 支持面向行的命令解釋器
- shlex — Simple lexical analysis
- Tk圖形用戶界面(GUI)
- tkinter — Tcl/Tk的Python接口
- tkinter.ttk — Tk themed widgets
- tkinter.tix — Extension widgets for Tk
- tkinter.scrolledtext — 滾動文字控件
- IDLE
- 其他圖形用戶界面(GUI)包
- 開發工具
- typing — 類型標注支持
- pydoc — Documentation generator and online help system
- doctest — Test interactive Python examples
- unittest — 單元測試框架
- unittest.mock — mock object library
- unittest.mock 上手指南
- 2to3 - 自動將 Python 2 代碼轉為 Python 3 代碼
- test — Regression tests package for Python
- test.support — Utilities for the Python test suite
- test.support.script_helper — Utilities for the Python execution tests
- 調試和分析
- bdb — Debugger framework
- faulthandler — Dump the Python traceback
- pdb — The Python Debugger
- The Python Profilers
- timeit — 測量小代碼片段的執行時間
- trace — Trace or track Python statement execution
- tracemalloc — Trace memory allocations
- 軟件打包和分發
- distutils — 構建和安裝 Python 模塊
- ensurepip — Bootstrapping the pip installer
- venv — 創建虛擬環境
- zipapp — Manage executable Python zip archives
- Python運行時服務
- sys — 系統相關的參數和函數
- sysconfig — Provide access to Python's configuration information
- builtins — 內建對象
- main — 頂層腳本環境
- warnings — Warning control
- dataclasses — 數據類
- contextlib — Utilities for with-statement contexts
- abc — 抽象基類
- atexit — 退出處理器
- traceback — Print or retrieve a stack traceback
- future — Future 語句定義
- gc — 垃圾回收器接口
- inspect — 檢查對象
- site — Site-specific configuration hook
- 自定義 Python 解釋器
- code — Interpreter base classes
- codeop — Compile Python code
- 導入模塊
- zipimport — Import modules from Zip archives
- pkgutil — Package extension utility
- modulefinder — 查找腳本使用的模塊
- runpy — Locating and executing Python modules
- importlib — The implementation of import
- Python 語言服務
- parser — Access Python parse trees
- ast — 抽象語法樹
- symtable — Access to the compiler's symbol tables
- symbol — 與 Python 解析樹一起使用的常量
- token — 與Python解析樹一起使用的常量
- keyword — 檢驗Python關鍵字
- tokenize — Tokenizer for Python source
- tabnanny — 模糊縮進檢測
- pyclbr — Python class browser support
- py_compile — Compile Python source files
- compileall — Byte-compile Python libraries
- dis — Python 字節碼反匯編器
- pickletools — Tools for pickle developers
- 雜項服務
- formatter — Generic output formatting
- Windows系統相關模塊
- msilib — Read and write Microsoft Installer files
- msvcrt — Useful routines from the MS VC++ runtime
- winreg — Windows 注冊表訪問
- winsound — Sound-playing interface for Windows
- Unix 專有服務
- posix — The most common POSIX system calls
- pwd — 用戶密碼數據庫
- spwd — The shadow password database
- grp — The group database
- crypt — Function to check Unix passwords
- termios — POSIX style tty control
- tty — 終端控制功能
- pty — Pseudo-terminal utilities
- fcntl — The fcntl and ioctl system calls
- pipes — Interface to shell pipelines
- resource — Resource usage information
- nis — Interface to Sun's NIS (Yellow Pages)
- Unix syslog 庫例程
- 被取代的模塊
- optparse — Parser for command line options
- imp — Access the import internals
- 未創建文檔的模塊
- 平臺特定模塊
- 擴展和嵌入 Python 解釋器
- 推薦的第三方工具
- 不使用第三方工具創建擴展
- 使用 C 或 C++ 擴展 Python
- 自定義擴展類型:教程
- 定義擴展類型:已分類主題
- 構建C/C++擴展
- 在Windows平臺編譯C和C++擴展
- 在更大的應用程序中嵌入 CPython 運行時
- Embedding Python in Another Application
- Python/C API 參考手冊
- 概述
- 代碼標準
- 包含文件
- 有用的宏
- 對象、類型和引用計數
- 異常
- 嵌入Python
- 調試構建
- 穩定的應用程序二進制接口
- The Very High Level Layer
- Reference Counting
- 異常處理
- Printing and clearing
- 拋出異常
- Issuing warnings
- Querying the error indicator
- Signal Handling
- Exception Classes
- Exception Objects
- Unicode Exception Objects
- Recursion Control
- 標準異常
- 標準警告類別
- 工具
- 操作系統實用程序
- 系統功能
- 過程控制
- 導入模塊
- Data marshalling support
- 語句解釋及變量編譯
- 字符串轉換與格式化
- 反射
- 編解碼器注冊與支持功能
- 抽象對象層
- Object Protocol
- 數字協議
- Sequence Protocol
- Mapping Protocol
- 迭代器協議
- 緩沖協議
- Old Buffer Protocol
- 具體的對象層
- 基本對象
- 數值對象
- 序列對象
- 容器對象
- 函數對象
- 其他對象
- Initialization, Finalization, and Threads
- 在Python初始化之前
- 全局配置變量
- Initializing and finalizing the interpreter
- Process-wide parameters
- Thread State and the Global Interpreter Lock
- Sub-interpreter support
- Asynchronous Notifications
- Profiling and Tracing
- Advanced Debugger Support
- Thread Local Storage Support
- 內存管理
- 概述
- 原始內存接口
- Memory Interface
- 對象分配器
- 默認內存分配器
- Customize Memory Allocators
- The pymalloc allocator
- tracemalloc C API
- 示例
- 對象實現支持
- 在堆中分配對象
- Common Object Structures
- Type 對象
- Number Object Structures
- Mapping Object Structures
- Sequence Object Structures
- Buffer Object Structures
- Async Object Structures
- 使對象類型支持循環垃圾回收
- API 和 ABI 版本管理
- 分發 Python 模塊
- 關鍵術語
- 開源許可與協作
- 安裝工具
- 閱讀指南
- 我該如何...?
- ...為我的項目選擇一個名字?
- ...創建和分發二進制擴展?
- 安裝 Python 模塊
- 關鍵術語
- 基本使用
- 我應如何 ...?
- ... 在 Python 3.4 之前的 Python 版本中安裝 pip ?
- ... 只為當前用戶安裝軟件包?
- ... 安裝科學計算類 Python 軟件包?
- ... 使用并行安裝的多個 Python 版本?
- 常見的安裝問題
- 在 Linux 的系統 Python 版本上安裝
- 未安裝 pip
- 安裝二進制編譯擴展
- Python 常用指引
- 將 Python 2 代碼遷移到 Python 3
- 簡要說明
- 詳情
- 將擴展模塊移植到 Python 3
- 條件編譯
- 對象API的更改
- 模塊初始化和狀態
- CObject 替換為 Capsule
- 其他選項
- Curses Programming with Python
- What is curses?
- Starting and ending a curses application
- Windows and Pads
- Displaying Text
- User Input
- For More Information
- 實現描述器
- 摘要
- 定義和簡介
- 描述器協議
- 發起調用描述符
- 描述符示例
- Properties
- 函數和方法
- Static Methods and Class Methods
- 函數式編程指引
- 概述
- 迭代器
- 生成器表達式和列表推導式
- 生成器
- 內置函數
- itertools 模塊
- The functools module
- Small functions and the lambda expression
- Revision History and Acknowledgements
- 引用文獻
- 日志 HOWTO
- 日志基礎教程
- 進階日志教程
- 日志級別
- 有用的處理程序
- 記錄日志中引發的異常
- 使用任意對象作為消息
- 優化
- 日志操作手冊
- 在多個模塊中使用日志
- 在多線程中使用日志
- 使用多個日志處理器和多種格式化
- 在多個地方記錄日志
- 日志服務器配置示例
- 處理日志處理器的阻塞
- Sending and receiving logging events across a network
- Adding contextual information to your logging output
- Logging to a single file from multiple processes
- Using file rotation
- Use of alternative formatting styles
- Customizing LogRecord
- Subclassing QueueHandler - a ZeroMQ example
- Subclassing QueueListener - a ZeroMQ example
- An example dictionary-based configuration
- Using a rotator and namer to customize log rotation processing
- A more elaborate multiprocessing example
- Inserting a BOM into messages sent to a SysLogHandler
- Implementing structured logging
- Customizing handlers with dictConfig()
- Using particular formatting styles throughout your application
- Configuring filters with dictConfig()
- Customized exception formatting
- Speaking logging messages
- Buffering logging messages and outputting them conditionally
- Formatting times using UTC (GMT) via configuration
- Using a context manager for selective logging
- 正則表達式HOWTO
- 概述
- 簡單模式
- 使用正則表達式
- 更多模式能力
- 修改字符串
- 常見問題
- 反饋
- 套接字編程指南
- 套接字
- 創建套接字
- 使用一個套接字
- 斷開連接
- 非阻塞的套接字
- 排序指南
- 基本排序
- 關鍵函數
- Operator 模塊函數
- 升序和降序
- 排序穩定性和排序復雜度
- 使用裝飾-排序-去裝飾的舊方法
- 使用 cmp 參數的舊方法
- 其它
- Unicode 指南
- Unicode 概述
- Python's Unicode Support
- Reading and Writing Unicode Data
- Acknowledgements
- 如何使用urllib包獲取網絡資源
- 概述
- Fetching URLs
- 處理異常
- info and geturl
- Openers and Handlers
- Basic Authentication
- Proxies
- Sockets and Layers
- 腳注
- Argparse 教程
- 概念
- 基礎
- 位置參數介紹
- Introducing Optional arguments
- Combining Positional and Optional arguments
- Getting a little more advanced
- Conclusion
- ipaddress模塊介紹
- 創建 Address/Network/Interface 對象
- 審查 Address/Network/Interface 對象
- Network 作為 Address 列表
- 比較
- 將IP地址與其他模塊一起使用
- 實例創建失敗時獲取更多詳細信息
- Argument Clinic How-To
- The Goals Of Argument Clinic
- Basic Concepts And Usage
- Converting Your First Function
- Advanced Topics
- 使用 DTrace 和 SystemTap 檢測CPython
- Enabling the static markers
- Static DTrace probes
- Static SystemTap markers
- Available static markers
- SystemTap Tapsets
- 示例
- Python 常見問題
- Python常見問題
- 一般信息
- 現實世界中的 Python
- 編程常見問題
- 一般問題
- 核心語言
- 數字和字符串
- 性能
- 序列(元組/列表)
- 對象
- 模塊
- 設計和歷史常見問題
- 為什么Python使用縮進來分組語句?
- 為什么簡單的算術運算得到奇怪的結果?
- 為什么浮點計算不準確?
- 為什么Python字符串是不可變的?
- 為什么必須在方法定義和調用中顯式使用“self”?
- 為什么不能在表達式中賦值?
- 為什么Python對某些功能(例如list.index())使用方法來實現,而其他功能(例如len(List))使用函數實現?
- 為什么 join()是一個字符串方法而不是列表或元組方法?
- 異常有多快?
- 為什么Python中沒有switch或case語句?
- 難道不能在解釋器中模擬線程,而非得依賴特定于操作系統的線程實現嗎?
- 為什么lambda表達式不能包含語句?
- 可以將Python編譯為機器代碼,C或其他語言嗎?
- Python如何管理內存?
- 為什么CPython不使用更傳統的垃圾回收方案?
- CPython退出時為什么不釋放所有內存?
- 為什么有單獨的元組和列表數據類型?
- 列表是如何在CPython中實現的?
- 字典是如何在CPython中實現的?
- 為什么字典key必須是不可變的?
- 為什么 list.sort() 沒有返回排序列表?
- 如何在Python中指定和實施接口規范?
- 為什么沒有goto?
- 為什么原始字符串(r-strings)不能以反斜杠結尾?
- 為什么Python沒有屬性賦值的“with”語句?
- 為什么 if/while/def/class語句需要冒號?
- 為什么Python在列表和元組的末尾允許使用逗號?
- 代碼庫和插件 FAQ
- 通用的代碼庫問題
- 通用任務
- 線程相關
- 輸入輸出
- 網絡 / Internet 編程
- 數據庫
- 數學和數字
- 擴展/嵌入常見問題
- 可以使用C語言中創建自己的函數嗎?
- 可以使用C++語言中創建自己的函數嗎?
- C很難寫,有沒有其他選擇?
- 如何從C執行任意Python語句?
- 如何從C中評估任意Python表達式?
- 如何從Python對象中提取C的值?
- 如何使用Py_BuildValue()創建任意長度的元組?
- 如何從C調用對象的方法?
- 如何捕獲PyErr_Print()(或打印到stdout / stderr的任何內容)的輸出?
- 如何從C訪問用Python編寫的模塊?
- 如何從Python接口到C ++對象?
- 我使用Setup文件添加了一個模塊,為什么make失敗了?
- 如何調試擴展?
- 我想在Linux系統上編譯一個Python模塊,但是缺少一些文件。為什么?
- 如何區分“輸入不完整”和“輸入無效”?
- 如何找到未定義的g++符號__builtin_new或__pure_virtual?
- 能否創建一個對象類,其中部分方法在C中實現,而其他方法在Python中實現(例如通過繼承)?
- Python在Windows上的常見問題
- 我怎樣在Windows下運行一個Python程序?
- 我怎么讓 Python 腳本可執行?
- 為什么有時候 Python 程序會啟動緩慢?
- 我怎樣使用Python腳本制作可執行文件?
- *.pyd 文件和DLL文件相同嗎?
- 我怎樣將Python嵌入一個Windows程序?
- 如何讓編輯器不要在我的 Python 源代碼中插入 tab ?
- 如何在不阻塞的情況下檢查按鍵?
- 圖形用戶界面(GUI)常見問題
- 圖形界面常見問題
- Python 是否有平臺無關的圖形界面工具包?
- 有哪些Python的GUI工具是某個平臺專用的?
- 有關Tkinter的問題
- “為什么我的電腦上安裝了 Python ?”
- 什么是Python?
- 為什么我的電腦上安裝了 Python ?
- 我能刪除 Python 嗎?
- 術語對照表
- 文檔說明
- Python 文檔貢獻者
- 解決 Bug
- 文檔錯誤
- 使用 Python 的錯誤追蹤系統
- 開始為 Python 貢獻您的知識
- 版權
- 歷史和許可證
- 軟件歷史
- 訪問Python或以其他方式使用Python的條款和條件
- Python 3.7.3 的 PSF 許可協議
- Python 2.0 的 BeOpen.com 許可協議
- Python 1.6.1 的 CNRI 許可協議
- Python 0.9.0 至 1.2 的 CWI 許可協議
- 集成軟件的許可和認可
- Mersenne Twister
- 套接字
- Asynchronous socket services
- Cookie management
- Execution tracing
- UUencode and UUdecode functions
- XML Remote Procedure Calls
- test_epoll
- Select kqueue
- SipHash24
- strtod and dtoa
- OpenSSL
- expat
- libffi
- zlib
- cfuhash
- libmpdec