sys --- 系統(tǒng)相關的參數(shù)和函數(shù)?

該模塊提供了一些變量和函數(shù)。這些變量可能被解釋器使用，也可能由解釋器提供。這些函數(shù)會影響解釋器。本模塊總是可用的。

sys.abiflags?

在POSIX系統(tǒng)上，以標準的 configure 腳本構建的 Python 中，這個變量會包含 PEP 3149 中定義的ABI標簽。

在 3.8 版更改: 默認的 flags 變?yōu)榱丝兆址ㄓ糜?pymalloc 的 m 旗標已經(jīng)移除）

3.2 新版功能.

sys.addaudithook(hook)?

將可調用對象 hook 附加到當前（子）解釋器的活動的審計鉤子列表中。

當通過 sys.audit() 函數(shù)引發(fā)審計事件時，每個鉤子將按照其被加入的先后順序被調用，調用時會傳入事件名稱和參數(shù)元組。 由 PySys_AddAuditHook() 添加的原生鉤子會先被調用，然后是當前（子）解釋器中添加的鉤子。 接下來這些鉤子會記錄事件，引發(fā)異常來中止操作，或是完全終止進程。

調用 sys.addaudithook() 時它自身將引發(fā)一個名為 sys.addaudithook 的審計事件且不附帶參數(shù)。 如果任何現(xiàn)有的鉤子引發(fā)了派生自 RuntimeError 的異常，則新的鉤子不會被添加并且該異常會被抑制。 其結果就是，調用者無法確保他們的鉤子已經(jīng)被添加，除非他們控制了全部現(xiàn)有的鉤子。

請參閱 審計事件表 以獲取由 CPython 引發(fā)的所有事件，并參閱 PEP 578 了解最初的設計討論。

3.8 新版功能.

在 3.8.1 版更改: 派生自 Exception （而非 RuntimeError ）的異常不會被抑制。

CPython implementation detail: 啟用跟蹤時（參閱 settrace() ），僅當可調用對象（鉤子）的 __cantrace__ 成員設置為 true 時，才會跟蹤該鉤子。否則，跟蹤功能將跳過該鉤子。

sys.argv?

一個列表，其中包含了被傳遞給 Python 腳本的命令行參數(shù)。 argv[0] 為腳本的名稱（是否是完整的路徑名取決于操作系統(tǒng)）。如果是通過 Python 解釋器的命令行參數(shù) -c 來執(zhí)行的， argv[0] 會被設置成字符串 '-c' 。如果沒有腳本名被傳遞給 Python 解釋器， argv[0] 為空字符串。

為了遍歷標準輸入，或者通過命令行傳遞的文件列表，參照 fileinput 模塊

另請參閱 sys.orig_argv。

備注

在 Unix 上，系統(tǒng)傳遞的命令行參數(shù)是字節(jié)類型的。Python 使用文件系統(tǒng)編碼和 "surrogateescape" 錯誤處理方案對它們進行解碼。當需要原始字節(jié)時，可以通過 [os.fsencode(arg) for arg in sys.argv] 來獲取。

sys.audit(event, *args)?

引發(fā)一個審計事件并觸發(fā)任何激活的審計鉤子。 event 是一個用于標識事件的字符串，args 會包含有關事件的更多信息的可選參數(shù)。 特定事件的參數(shù)的數(shù)量和類型會被視為是公有的穩(wěn)定 API 且不應當在版本之間進行修改。

例如，有一個審計事件的名稱為 os.chdir。 此事件具有一個名為 path 的參數(shù)，該參數(shù)將包含所請求的新工作目錄。

sys.audit() 將調用現(xiàn)有的審計鉤子，傳入事件名稱和參數(shù)，并將重新引發(fā)來自任何鉤子的第一個異常。 通常來說，如果有一個異常被引發(fā)，則它不應當被處理且其進程應當被盡可能快地終止。 這將允許鉤子實現(xiàn)來決定對特定事件要如何反應：它們可以只是將事件寫入日志或是通過引發(fā)異常來中止操作。

鉤子程序由 sys.addaudithook() 或 PySys_AddAuditHook() 函數(shù)添加。

與本函數(shù)相等效的原生函數(shù)是 PySys_Audit()，應盡量使用原生函數(shù)。

參閱 審計事件表 以獲取 CPython 定義的所有審計事件。

3.8 新版功能.

sys.base_exec_prefix?

在 site.py 運行之前， Python 啟動的時候被設置為跟 exec_prefix 同樣的值。如果不是運行在 虛擬環(huán)境 中，兩個值會保持相同；如果 site.py 發(fā)現(xiàn)處于一個虛擬環(huán)境中， prefix 和 exec_prefix 將會指向虛擬環(huán)境。然而 base_prefix 和 base_exec_prefix 將仍然會指向基礎的 Python 環(huán)境（用來創(chuàng)建虛擬環(huán)境的 Python 環(huán)境）

3.3 新版功能.

sys.base_prefix?

在 site.py 運行之前， Python 啟動的時候被設置為跟 prefix 同樣的值。如果不是運行在 虛擬環(huán)境 中, 兩個值會保持相同；如果 site.py 發(fā)現(xiàn)處于一個虛擬環(huán)境中， prefix 和 exec_prefix 將會指向虛擬環(huán)境。然而 base_prefix 和 base_exec_prefix 將仍然會指向基礎的 Python 環(huán)境（用來創(chuàng)建虛擬環(huán)境的 Python 環(huán)境）

3.3 新版功能.

sys.byteorder?

本地字節(jié)順序的指示符。在大端序（最高有效位優(yōu)先）操作系統(tǒng)上值為 'big' ，在小端序（最低有效位優(yōu)先）操作系統(tǒng)上為 'little' 。

sys.builtin_module_names?

一個包含所有被編譯進 Python 解釋器的模塊的名稱的字符串元組。 （此信息無法通過任何其他辦法獲取 --- modules.keys() 僅會列出導入的模塊。）

另請參閱 sys.stdlib_module_names 列表。

sys.call_tracing(func, args)?

在啟用跟蹤時調用 func(*args) 來保存跟蹤狀態(tài)，然后恢復跟蹤狀態(tài)。這將從檢查點的調試器調用，以便遞歸地調試其他的一些代碼。

sys.copyright?

一個字符串，包含了 Python 解釋器有關的版權信息

sys._clear_type_cache()?

清除內部的類型緩存。類型緩存是為了加速查找方法和屬性的。在調試引用泄漏的時候調用這個函數(shù) 只會 清除不必要的引用。

這個函數(shù)應該只在內部為了一些特定的目的使用。

sys._current_frames()?

返回一個字典，存放著每個線程的標識符與（調用本函數(shù)時）該線程棧頂?shù)膸ó斍盎顒拥膸┲g的映射。注意 traceback 模塊中的函數(shù)可以在給定某一幀的情況下構建調用堆棧。

這對于調試死鎖最有用：本函數(shù)不需要死鎖線程的配合，并且只要這些線程的調用棧保持死鎖，它們就是凍結的。在調用本代碼來檢查棧頂?shù)膸哪且豢?，非死鎖線程返回的幀可能與該線程當前活動的幀沒有任何關系。

這個函數(shù)應該只在內部為了一些特定的目的使用。

引發(fā)一個 審計事件 sys._current_frames，沒有附帶參數(shù)。

sys._current_exceptions()?

返回一個字典，存放著每個線程的標識與調用此函數(shù)時該線程當前活動幀的棧頂異常之間的映射。 如果某個線程當前未在處理異常，它將不被包括在結果字典中。

這對于靜態(tài)性能分析來說最為有用。

這個函數(shù)應該只在內部為了一些特定的目的使用。

引發(fā)一個 審計事件 sys._current_exceptions，不附帶任何參數(shù)。

sys.breakpointhook()?

本鉤子函數(shù)由內建函數(shù) breakpoint() 調用。默認情況下，它將進入 pdb 調試器，但可以將其改為任何其他函數(shù)，以選擇使用哪個調試器。

該函數(shù)的特征取決于其調用的函數(shù)。例如，默認綁定（即 pdb.set_trace() ）不要求提供參數(shù)，但可以將綁定換成要求提供附加參數(shù)（位置參數(shù)/關鍵字參數(shù)）的函數(shù)。內建函數(shù) breakpoint() 直接將其 *args 和 **kws 傳入。breakpointhooks() 返回的所有內容都會從 breakpoint() 返回。

默認的實現(xiàn)首先會查詢環(huán)境變量 PYTHONBREAKPOINT。如果將該變量設置為 "0"，則本函數(shù)立即返回，表示在斷點處無操作。如果未設置該環(huán)境變量或將其設置為空字符串，則調用 pdb.set_trace()。否則，此變量應指定要運行的函數(shù)，指定函數(shù)時應使用 Python 的點導入命名法，如 package.subpackage.module.function。這種情況下將導入 package.subpackage.module，且導入的模塊必須有一個名為 function() 的可調用對象。該可調用對象會運行，*args 和 **kws 會傳入，且無論 function() 返回什么，sys.breakpointhook() 都將返回到內建函數(shù) breakpoint()。

請注意，如果在導入 PYTHONBREAKPOINT 指定的可調用對象時出錯，則將報告一個 RuntimeWarning 并忽略斷點。

另請注意，如果以編程方式覆蓋 sys.breakpointhook()，則 不會 查詢 PYTHONBREAKPOINT。

3.7 新版功能.

sys._debugmallocstats()?

將有關 CPython 內存分配器狀態(tài)的底層的信息打印至 stderr。

如果 Python 是 以調試模式編譯的 <debug-build> (configure --with-pydebug option)，它還會執(zhí)行一些消耗性能的內部一致性檢查。

3.3 新版功能.

CPython implementation detail: 本函數(shù)僅限 CPython。此處沒有定義確切的輸出格式，且可能會更改。

sys.dllhandle?

指向 Python DLL 句柄的整數(shù)。

可用性: Windows。

sys.displayhook(value)?

如果 value 不是 None，則本函數(shù)會將 repr(value) 打印至 sys.stdout，并將 value 保存在 builtins._ 中。如果 repr(value) 無法用 sys.stdout.errors 錯誤處理方案（可能為 'strict' ）編碼為 sys.stdout.encoding，則用 'backslashreplace' 錯誤處理方案將其編碼為 sys.stdout.encoding。

在交互式 Python 會話中運行 expression 產(chǎn)生結果后，將在結果上調用 sys.displayhook。若要自定義這些 value 的顯示，可以將 sys.displayhook 指定為另一個單參數(shù)函數(shù)。

偽代碼:

def displayhook(value):
    if value is None:
        return
    # Set '_' to None to avoid recursion
    builtins._ = None
    text = repr(value)
    try:
        sys.stdout.write(text)
    except UnicodeEncodeError:
        bytes = text.encode(sys.stdout.encoding, 'backslashreplace')
        if hasattr(sys.stdout, 'buffer'):
            sys.stdout.buffer.write(bytes)
        else:
            text = bytes.decode(sys.stdout.encoding, 'strict')
            sys.stdout.write(text)
    sys.stdout.write("\n")
    builtins._ = value

在 3.2 版更改: 在發(fā)生 UnicodeEncodeError 時使用 'backslashreplace' 錯誤處理方案。

sys.dont_write_bytecode?

如果該值為 true，則 Python 在導入源碼模塊時將不會嘗試寫入 .pyc 文件。該值會被初始化為 True 或 False，依據(jù)是 -B 命令行選項和 PYTHONDONTWRITEBYTECODE 環(huán)境變量，可以自行設置該值，來控制是否生成字節(jié)碼文件。

sys._emscripten_info?

A named tuple holding information about the environment on the wasm32-emscripten platform. The named tuple is provisional and may change in the future.

屬性	說明
emscripten_version	Emscripten version as tuple of ints (major, minor, micro), e.g. (3, 1, 8).
runtime	Runtime string, e.g. browser user agent, 'Node.js v14.18.2', or 'UNKNOWN'.
pthreads	True if Python is compiled with Emscripten pthreads support.
shared_memory	True if Python is compiled with shared memory support.

Availability: WebAssembly Emscripten platform (wasm32-emscripten).

3.11 新版功能.

sys.pycache_prefix?

如果將該值設為某個目錄（不是 None ），Python 會將字節(jié)碼緩存文件 .pyc 寫入到以該目錄為根的并行目錄樹中（并從中讀?。?，而不是在源碼樹中的 __pycache__ 目錄下讀寫。源碼樹中所有的 __pycache__ 目錄都將被忽略，并將在 pycache prefix 內寫入新的 .pyc 文件。因此，如果使用 compileall 作為預構建步驟，則必須確保預構建時使用的 pycache prefix （如果有）與將來運行的時候相同。

相對路徑將解釋為相對于當前工作目錄。

該值的初值設置，依據(jù) -X pycache_prefix=PATH 命令行選項或 PYTHONPYCACHEPREFIX 環(huán)境變量的值（命令行優(yōu)先）。如果兩者均未設置，則為 None。

3.8 新版功能.

sys.excepthook(type, value, traceback)?

本函數(shù)會將所給的回溯和異常輸出到 sys.stderr 中。

當拋出一個異常，且未被捕獲時，解釋器將調用 sys.excepthook 并帶有三個參數(shù)：異常類、異常實例和一個回溯對象。在交互式會話中，這會在控制權返回到提示符之前發(fā)生。在 Python 程序中，這會在程序退出之前發(fā)生。如果要自定義此類頂級異常的處理過程，可以將另一個 3 個參數(shù)的函數(shù)賦給 sys.excepthook。

引發(fā)一個 審計事件 sys.excepthook，附帶參數(shù) hook, type, value, traceback。

參見

sys.unraisablehook() 函數(shù)處理無法拋出的異常，threading.excepthook() 函數(shù)處理 threading.Thread.run() 拋出的異常。

sys.__breakpointhook__?

sys.__displayhook__?

sys.__excepthook__?

sys.__unraisablehook__?

程序開始時，這些對象存有 breakpointhook、displayhook、excepthook 和 unraisablehook 的初始值。保存它們是為了可以在 breakpointhook、displayhook 和 excepthook、unraisablehook 被破壞或被替換時恢復它們。

3.7 新版功能: __breakpointhook__

3.8 新版功能: __unraisablehook__

sys.exception()?

This function, when called while an exception handler is executing (such as an except or except* clause), returns the exception instance that was caught by this handler. When exception handlers are nested within one another, only the exception handled by the innermost handler is accessible.

If no exception handler is executing, this function returns None.

3.11 新版功能.

sys.exc_info()?

This function returns the old-style representation of the handled exception. If an exception e is currently handled (so exception() would return e), exc_info() returns the tuple (type(e), e, e.__traceback__). That is, a tuple containing the type of the exception (a subclass of BaseException), the exception itself, and a traceback object which typically encapsulates the call stack at the point where the exception last occurred.

If no exception is being handled anywhere on the stack, this function return a tuple containing three None values.

在 3.11 版更改: The type and traceback fields are now derived from the value (the exception instance), so when an exception is modified while it is being handled, the changes are reflected in the results of subsequent calls to exc_info().

sys.exec_prefix?

一個字符串，提供特定域的目錄前綴，該目錄中安裝了與平臺相關的 Python 文件，默認也是 '/usr/local'。該目錄前綴可以在構建時使用 configure 腳本的 --exec-prefix 參數(shù)進行設置。具體而言，所有配置文件（如 pyconfig.h 頭文件）都安裝在目錄 exec_prefix/lib/pythonX.Y/config 中，共享庫模塊安裝在 exec_prefix/lib/pythonX.Y/lib-dynload 中，其中 X.Y 是 Python 的版本號，如 3.2。

備注

如果在一個 虛擬環(huán)境 中，那么該值將在 site.py 中被修改，指向虛擬環(huán)境。Python 安裝位置仍然可以用 base_exec_prefix 來獲取。

sys.executable?

一個字符串，提供 Python 解釋器的可執(zhí)行二進制文件的絕對路徑，僅在部分系統(tǒng)中此值有意義。如果 Python 無法獲取其可執(zhí)行文件的真實路徑，則 sys.executable 將為空字符串或 None。

sys.exit([arg])?

Raise a SystemExit exception, signaling an intention to exit the interpreter.

可選參數(shù) arg 可以是表示退出狀態(tài)的整數(shù)（默認為 0），也可以是其他類型的對象。如果它是整數(shù)，則 shell 等將 0 視為“成功終止”，非零值視為“異常終止”。大多數(shù)系統(tǒng)要求該值的范圍是 0--127，否則會產(chǎn)生不確定的結果。某些系統(tǒng)為退出代碼約定了特定的含義，但通常尚不完善；Unix 程序通常用 2 表示命令行語法錯誤，用 1 表示所有其他類型的錯誤。傳入其他類型的對象，如果傳入 None 等同于傳入 0，如果傳入其他對象則將其打印至 stderr，且退出代碼為 1。特別地，sys.exit("some error message") 可以在發(fā)生錯誤時快速退出程序。

Since exit() ultimately "only" raises an exception, it will only exit the process when called from the main thread, and the exception is not intercepted. Cleanup actions specified by finally clauses of try statements are honored, and it is possible to intercept the exit attempt at an outer level.

在 3.6 版更改: 在 Python 解釋器捕獲 SystemExit 后，如果在清理中發(fā)生錯誤（如清除標準流中的緩沖數(shù)據(jù)時出錯），則退出狀態(tài)碼將變?yōu)?120。

sys.flags?

具名元組 flags 含有命令行標志的狀態(tài)。這些屬性是只讀的。

attribute -- 屬性	標志
debug	-d
inspect	-i
interactive	-i
isolated	-I
optimize	-O 或 -OO
dont_write_bytecode	-B
no_user_site	-s
no_site	-S
ignore_environment	-E
verbose	-v
bytes_warning	-b
quiet	-q
hash_randomization	-R
dev_mode	-X dev (Python 開發(fā)模式)
utf8_mode	-X utf8
safe_path	-P

在 3.2 版更改: 為新的 -q 標志添加了 quiet 屬性

3.2.3 新版功能: hash_randomization 屬性

在 3.3 版更改: 刪除了過時的 division_warning 屬性

在 3.4 版更改: 為 -I isolated 標志添加了 isolated 屬性。

在 3.7 版更改: 為新的 Python 開發(fā)模式 添加了 dev_mode 屬性，為新的 -X utf8 標志添加了 utf8_mode 屬性。

在 3.11 版更改: Added the safe_path attribute for -P option.

sys.float_info?

一個 具名元組，存有浮點型的相關信息。它包含的是關于精度和內部表示的底層信息。這些值與標準頭文件 float.h 中為 C 語言定義的各種浮點常量對應，詳情請參閱 1999 ISO/IEC C 標準 [C99] 的 5.2.4.2.2 節(jié)，'Characteristics of floating types（浮點型的特性）'。

attribute -- 屬性	float.h 宏	說明
epsilon	DBL_EPSILON	大于 1.0 的最小值和 1.0 之間的差，表示為浮點數(shù) 另請參閱 math.ulp()。
dig	DBL_DIG	浮點數(shù)可以真實表示的最大十進制數(shù)字；見下文
mant_dig	DBL_MANT_DIG	浮點數(shù)精度：radix 基數(shù)下的浮點數(shù)有效位數(shù)
max	DBL_MAX	可表示的最大正浮點數(shù)（非無窮）
max_exp	DBL_MAX_EXP	使得 radix**(e-1) 是可表示的浮點數(shù)（非無窮）的最大整數(shù) e
max_10_exp	DBL_MAX_10_EXP	使得 10**e 在可表示的浮點數(shù)（非無窮）范圍內的最大整數(shù) e
min	DBL_MIN	可表示的最小正 規(guī)格化 浮點數(shù) 使用 math.ulp(0.0) 獲取可表示的最小正 非規(guī)格化 浮點數(shù)
min_exp	DBL_MIN_EXP	使得 radix**(e-1) 是規(guī)格化浮點數(shù)的最小整數(shù) e
min_10_exp	DBL_MIN_10_EXP	使得 10**e 是規(guī)格化浮點數(shù)的最小整數(shù) e
radix	FLT_RADIX	指數(shù)表示法中采用的基數(shù)
rounds	FLT_ROUNDS	整數(shù)常數(shù)，表示算術運算中的舍入方式。它反映了解釋器啟動時系統(tǒng)的 FLT_ROUNDS 宏的值。關于可能的值及其含義的說明，請參閱 C99 標準 5.2.4.2.2 節(jié)。

關于 sys.float_info.dig 屬性的進一步說明。如果 s 是表示十進制數(shù)的字符串，而該數(shù)最多有 sys.float_info.dig 位有效數(shù)字，則將 s 轉換為 float 再轉回去將恢復原先相同十進制值的字符串:

>>>

>>> import sys
>>> sys.float_info.dig
15
>>> s = '3.14159265358979'    # decimal string with 15 significant digits
>>> format(float(s), '.15g')  # convert to float and back -> same value
'3.14159265358979'

但是對于超過 sys.float_info.dig 位有效數(shù)字的字符串，轉換前后并非總是相同:

>>>

>>> s = '9876543211234567'    # 16 significant digits is too many!
>>> format(float(s), '.16g')  # conversion changes value
'9876543211234568'

sys.float_repr_style?

一個字符串，反映 repr() 函數(shù)在浮點數(shù)上的行為。如果該字符串是 'short'，那么對于（非無窮的）浮點數(shù) x，repr(x) 將會生成一個短字符串，滿足 float(repr(x)) == x 的特性。這是 Python 3.1 及更高版本中的常見行為。否則 float_repr_style 的值將是 'legacy'，此時 repr(x) 的行為方式將與 Python 3.1 之前的版本相同。

3.1 新版功能.

sys.getallocatedblocks()?

返回解釋器當前已分配的內存塊數(shù)，無論它們大小如何。本函數(shù)主要用于跟蹤和調試內存泄漏。因為解釋器有內部緩存，所以不同調用之間結果會變化?？赡苄枰{用 _clear_type_cache() 和 gc.collect() 使結果更容易預測。

如果當前 Python 構建或實現(xiàn)無法合理地計算此信息，允許 getallocatedblocks() 返回 0。

3.4 新版功能.

sys.getandroidapilevel()?

返回一個整數(shù)，表示 Android 構建時 API 版本。

可用性：Android。

3.7 新版功能.

sys.getdefaultencoding()?

返回當前 Unicode 實現(xiàn)所使用的默認字符串編碼名稱。

sys.getdlopenflags()?

返回當前 dlopen() 調用所使用的標志位的值。標志值對應的符號名稱可以在 os 模塊中找到（形如 RTLD_xxx 的常量，如 os.RTLD_LAZY ）。

可用性: Unix。

sys.getfilesystemencoding()?

獲取 文件系統(tǒng)編碼格式: 與 文件系統(tǒng)錯誤處理句柄 一起使用以便在 Unicode 文件名和字節(jié)文件名之間進行轉換。 文件系統(tǒng)錯誤處理句柄是由 getfilesystemencoding() 來返回的。

為獲得最佳兼容性，在任何時候都應使用 str 來表示文件名，盡管使用 bytes 來表示文件名也是受支持的。 接受還返回文件名的函數(shù)應當支持 str 或 bytes 并在內部將其轉換為系統(tǒng)首選的表示形式。

應使用 os.fsencode() 和 os.fsdecode() 來保證所采用的編碼和錯誤處理方案都是正確的。

filesystem encoding and error handler 是在 Python 啟動時通過 PyConfig_Read() 函數(shù)來配置的：請參閱 PyConfig 的 filesystem_encoding 和 filesystem_errors 等成員。

在 3.2 版更改: getfilesystemencoding() 的結果將不再有可能是 None。

在 3.6 版更改: Windows 不再保證會返回 'mbcs'。詳情請參閱 PEP 529 和 _enablelegacywindowsfsencoding()。

在 3.7 版更改: 返回 'utf-8'，如果啟用了 Python UTF-8 模式 的話。

sys.getfilesystemencodeerrors()?

獲取 文件系統(tǒng)錯誤處理句柄: 該錯誤處理句柄與 文件系統(tǒng)編碼格式 一起使用以便在 Unicode 文件名和字節(jié)文件名之間進程轉換。 文件系統(tǒng)編碼格式是由 getfilesystemencoding() 來返回的。

應使用 os.fsencode() 和 os.fsdecode() 來保證所采用的編碼和錯誤處理方案都是正確的。

filesystem encoding and error handler 是在 Python 啟動時通過 PyConfig_Read() 函數(shù)來配置的：請參閱 PyConfig 的 filesystem_encoding 和 filesystem_errors 等成員。

3.6 新版功能.

sys.getrefcount(object)?

返回 object 的引用計數(shù)。返回的計數(shù)通常比預期的多一，因為它包括了作為 getrefcount() 參數(shù)的這一次（臨時）引用。

sys.getrecursionlimit()?

返回當前的遞歸限制值，即 Python 解釋器堆棧的最大深度。此限制可防止無限遞歸導致的 C 堆棧溢出和 Python 崩潰。該值可以通過 setrecursionlimit() 設置。

sys.getsizeof(object[, default])?

返回對象的大?。ㄒ宰止?jié)為單位）。該對象可以是任何類型。所有內建對象返回的結果都是正確的，但對于第三方擴展不一定正確，因為這與具體實現(xiàn)有關。

只計算直接分配給對象的內存消耗，不計算它所引用的對象的內存消耗。

對象不提供計算大小的方法時，如果傳入過 default 則返回它，否則拋出 TypeError 異常。

如果對象由垃圾回收器管理，則 getsizeof() 將調用對象的 __sizeof__ 方法，并在上層添加額外的垃圾回收器。

可以參考 recursive sizeof recipe 中的示例，關于遞歸調用 getsizeof() 來得到各個容器及其所有內容物的大小。

sys.getswitchinterval()?

返回解釋器的“線程切換間隔時間”，請參閱 setswitchinterval()。

3.2 新版功能.

sys._getframe([depth])?

返回來自調用棧的一個幀對象。如果傳入可選整數(shù) depth，則返回從棧頂往下相應調用層數(shù)的幀對象。如果該數(shù)比調用棧更深，則拋出 ValueError。depth 的默認值是 0，返回調用棧頂部的幀。

引發(fā)一個 審計事件 sys._getframe，沒有附帶參數(shù)。

CPython implementation detail: 這個函數(shù)應該只在內部為了一些特定的目的使用。不保證它在所有 Python 實現(xiàn)中都存在。

sys.getprofile()?

返回由 setprofile() 設置的性能分析函數(shù)。

sys.gettrace()?

返回由 settrace() 設置的跟蹤函數(shù)。

CPython implementation detail: gettrace() 函數(shù)僅用于實現(xiàn)調試器，性能分析器，打包工具等。它的行為是實現(xiàn)平臺的一部分，而不是語言定義的一部分，因此并非在所有 Python 實現(xiàn)中都可用。

sys.getwindowsversion()?

返回一個具名元組，描述當前正在運行的 Windows 版本。元素名稱包括 major, minor, build, platform, service_pack, service_pack_minor, service_pack_major, suite_mask, product_type 和 platform_version。service_pack 包含一個字符串，platform_version 包含一個三元組，其他所有值都是整數(shù)。元素也可以通過名稱來訪問，所以 sys.getwindowsversion()[0] 與 sys.getwindowsversion().major 是等效的。為保持與舊版本的兼容性，只有前 5 個元素可以用索引檢索。

platform 將會是 2 (VER_PLATFORM_WIN32_NT)。

product_type 可能是以下值之一：

常量	含意
1 (VER_NT_WORKSTATION)	系統(tǒng)是工作站。
2 (VER_NT_DOMAIN_CONTROLLER)	系統(tǒng)是域控制器。
3 (VER_NT_SERVER)	系統(tǒng)是服務器，但不是域控制器。

本函數(shù)包裝了 Win32 GetVersionEx() 函數(shù)，參閱 Microsoft 文檔有關 OSVERSIONINFOEX() 的內容可獲取這些字段的更多信息。

platform_version 返回當前操作系統(tǒng)的主要版本、次要版本和編譯版本號，而不是為該進程所模擬的版本。 它旨在用于日志記錄而非特性檢測。

備注

platform_version 會從 kernel32.dll 獲取版本號，這個版本可能與 OS 版本不同。 請使用 platform 模塊來獲取準確的 OS 版本號。

可用性: Windows。

在 3.2 版更改: 更改為具名元組，添加 service_pack_minor, service_pack_major, suite_mask 和 product_type。

在 3.6 版更改: 添加了 platform_version

sys.get_asyncgen_hooks()?

返回一個 asyncgen_hooks 對象，該對象類似于 namedtuple，形式為 (firstiter, finalizer)，其中 firstiter 和 finalizer 為 None 或函數(shù)，函數(shù)以 異步生成器迭代器 作為參數(shù)，并用于在事件循環(huán)中干預異步生成器的終結。

3.6 新版功能: 詳情請參閱 PEP 525。

備注

本函數(shù)已添加至暫定軟件包（詳情請參閱 PEP 411 ）。

sys.get_coroutine_origin_tracking_depth()?

獲取由 set_coroutine_origin_tracking_depth() 設置的協(xié)程來源的追蹤深度。

3.7 新版功能.

備注

本函數(shù)已添加至暫定軟件包（詳情請參閱 PEP 411 ）。僅將其用于調試目的。

sys.hash_info?

一個 具名元組，給出數(shù)字類型的哈希的實現(xiàn)參數(shù)。關于數(shù)字類型的哈希的詳情請參閱 數(shù)字類型的哈希運算。

attribute -- 屬性	說明
width	用于哈希值的位寬度
modulus	用于數(shù)字散列方案的素數(shù)模數(shù)P。
inf	為正無窮大返回的哈希值
nan	（該屬性已不再被使用）
imag	用于復數(shù)虛部的乘數(shù)
algorithm	字符串、字節(jié)和內存視圖的哈希算法的名稱
hash_bits	哈希算法的內部輸出大小。
seed_bits	散列算法的種子密鑰的大小

3.2 新版功能.

在 3.4 版更改: 添加了 algorithm, hash_bits 和 seed_bits

sys.hexversion?

編碼為單個整數(shù)的版本號。該整數(shù)會確保每個版本都自增，其中適當包括了未發(fā)布版本。舉例來說，要測試 Python 解釋器的版本不低于 1.5.2，請使用:

if sys.hexversion >= 0x010502F0:
    # use some advanced feature
    ...
else:
    # use an alternative implementation or warn the user
    ...

之所以稱它為 hexversion，是因為只有將它傳入內置函數(shù) hex() 后，其結果才看起來有意義。也可以使用 具名元組 sys.version_info，它對相同信息有著更人性化的編碼。

關于 hexversion 的更多信息可以在 API 和 ABI 版本管理 中找到。

sys.implementation?

一個對象，該對象包含當前運行的 Python 解釋器的實現(xiàn)信息。所有 Python 實現(xiàn)中都必須存在下列屬性。

name 是當前實現(xiàn)的標識符，如 'cpython'。實際的字符串由 Python 實現(xiàn)定義，但保證是小寫字母。

version 是一個具名元組，格式與 sys.version_info 相同。它表示 Python 實現(xiàn) 的版本。 另一個（由 sys.version_info 表示）是當前解釋器遵循的相應 Python 語言 的版本，兩者具有不同的含義。 例如，對于 PyPy 1.8，sys.implementation.version 可能是 sys.version_info(1, 8, 0, 'final', 0)，而 sys.version_info 則是 sys.version_info(2, 7, 2, 'final', 0)。對于 CPython 而言兩個值是相同的，因為它是參考實現(xiàn)。

hexversion 是十六進制的實現(xiàn)版本，類似于 sys.hexversion。

cache_tag 是導入機制使用的標記，用于已緩存模塊的文件名。按照慣例，它將由實現(xiàn)的名稱和版本組成，如 'cpython-33'。但如果合適，Python 實現(xiàn)可以使用其他值。如果 cache_tag 被置為 None，表示模塊緩存已禁用。

sys.implementation 可能包含相應 Python 實現(xiàn)的其他屬性。這些非標準屬性必須以下劃線開頭，此處不詳細闡述。無論其內容如何，sys.implementation 在解釋器運行期間或不同實現(xiàn)版本之間都不會更改。（但是不同 Python 語言版本間可能會不同。）詳情請參閱 PEP 421。

3.3 新版功能.

備注

新的必要屬性的添加必須經(jīng)過常規(guī)的 PEP 過程。詳情請參閱 PEP 421。

sys.int_info?

一個 具名元組，包含 Python 內部整數(shù)表示形式的信息。這些屬性是只讀的。

屬性	說明
bits_per_digit	每個數(shù)字占有的位數(shù)。Python 內部將整數(shù)存儲在基底 2**int_info.bits_per_digit
sizeof_digit	用于表示數(shù)字的C類型的字節(jié)大小

3.1 新版功能.

sys.__interactivehook__?

當本屬性存在，則以 交互模式 啟動解釋器時，將自動（不帶參數(shù)地）調用本屬性的值。該過程是在讀取 PYTHONSTARTUP 文件之后完成的，所以可以在該文件中設置這一鉤子。site 模塊 設置了這一屬性。

引發(fā)一個 審計事件 cpython.run_interactivehook，附帶參數(shù) hook。

3.4 新版功能.

sys.intern(string)?

將 string 插入 "interned" （駐留）字符串表，返回被插入的字符串 -- 它是 string 本身或副本。駐留字符串對提高字典查找的性能很有用 -- 如果字典中的鍵已駐留，且所查找的鍵也已駐留，則鍵（取散列后）的比較可以用指針代替字符串來比較。通常，Python 程序使用到的名稱會被自動駐留，且用于保存模塊、類或實例屬性的字典的鍵也已駐留。

駐留字符串不是永久存在的，對 intern() 返回值的引用必須保留下來，才能發(fā)揮駐留字符串的優(yōu)勢。

sys.is_finalizing()?

如果 Python 解釋器 正在關閉 則返回 True，否則返回 False。

3.5 新版功能.

sys.last_type?

sys.last_value?

sys.last_traceback?

這三個變量并非總是有定義，僅當有異常未處理，且解釋器打印了錯誤消息和堆?；厮輹r，才會給它們賦值。它們的預期用途，是允許交互中的用戶導入調試器模塊，進行事后調試，而不必重新運行導致錯誤的命令。（通常使用 import pdb; pdb.pm() 進入事后調試器，詳情請參閱 pdb 模塊。）

這些變量的含義與上述 exc_info() 返回值的含義相同。

sys.maxsize?

一個整數(shù)，表示 Py_ssize_t 類型的變量可以取到的最大值。在 32 位平臺上通常為 2**31 - 1，在 64 位平臺上通常為 2**63 - 1。

sys.maxunicode?

一個整數(shù)，表示最大的 Unicode 碼點值，如 1114111 （十六進制為 0x10FFFF ）。

在 3.3 版更改: 在 PEP 393 之前，sys.maxunicode 曾是 0xFFFF 或 0x10FFFF，具體取決于配置選項，該選項指定將 Unicode 字符存儲為 UCS-2 還是 UCS-4。

sys.meta_path?

一個由 元路徑查找器 對象組成的列表，當查找需要導入的模塊時，會調用這些對象的 find_spec() 方法，觀察這些對象是否能找到所需模塊。調用 find_spec() 方法最少需要傳入待導入模塊的絕對名稱。如果待導入模塊包含在一個包中，則父包的 __path__ 屬性將作為第二個參數(shù)被傳入。該方法返回 模塊規(guī)格，找不到模塊則返回 None。

參見

importlib.abc.MetaPathFinder

抽象基類，定義了 meta_path 內的查找器對象的接口。

importlib.machinery.ModuleSpec

find_spec() 返回的實例所對應的具體類。

在 3.4 版更改: 在 Python 3.4 中通過 PEP 451 引入了 模塊規(guī)格。早期版本的 Python 會尋找一個稱為 find_module() 的方法。如果某個 meta_path 條目沒有 find_spec() 方法，就會回退去調用前一種方法。

sys.modules?

This is a dictionary that maps module names to modules which have already been loaded. This can be manipulated to force reloading of modules and other tricks. However, replacing the dictionary will not necessarily work as expected and deleting essential items from the dictionary may cause Python to fail. If you want to iterate over this global dictionary always use sys.modules.copy() or tuple(sys.modules) to avoid exceptions as its size may change during iteration as a side effect of code or activity in other threads.

sys.orig_argv?

傳給 Python 可執(zhí)行文件的原始命令行參數(shù)列表。

另請參閱 sys.argv。

3.10 新版功能.

sys.path?

一個由字符串組成的列表，用于指定模塊的搜索路徑。初始化自環(huán)境變量 PYTHONPATH，再加上一條與安裝有關的默認路徑。

By default, as initialized upon program startup, a potentially unsafe path is prepended to sys.path (before the entries inserted as a result of PYTHONPATH):

• python -m module command line: prepend the current working directory.

• python script.py command line: prepend the script's directory. If it's a symbolic link, resolve symbolic links.

• python -c code and python (REPL) command lines: prepend an empty string, which means the current working directory.

To not prepend this potentially unsafe path, use the -P command line option or the PYTHONSAFEPATH environment variable?

程序可以隨意修改本列表用于自己的目的。只能向 sys.path 中添加 string 和 bytes 類型，其他數(shù)據(jù)類型將在導入期間被忽略。

參見

• site 模塊，該模塊描述了如何使用 .pth 文件來擴展 sys.path。

sys.path_hooks?

一個由可調用對象組成的列表，這些對象接受一個路徑作為參數(shù)，并嘗試為該路徑創(chuàng)建一個 查找器。如果成功創(chuàng)建查找器，則可調用對象將返回它，否則將引發(fā) ImportError 異常。

本特性最早在 PEP 302 中被提及。

sys.path_importer_cache?

一個字典，作為 查找器 對象的緩存。key 是傳入 sys.path_hooks 的路徑，value 是相應已找到的查找器。如果路徑是有效的文件系統(tǒng)路徑，但在 sys.path_hooks 中未找到查找器，則存入 None。

本特性最早在 PEP 302 中被提及。

在 3.3 版更改: 未找到查找器時，改為存儲 None，而不是 imp.NullImporter。

sys.platform?

本字符串是一個平臺標識符，舉例而言，該標識符可用于將特定平臺的組件追加到 sys.path 中。

對于 Unix 系統(tǒng)（除 Linux 和 AIX 外），該字符串是 Python 構建時的 uname -s 返回的小寫操作系統(tǒng)名稱，并附加了 uname -r 返回的系統(tǒng)版本的第一部分，如 'sunos5' 或 'freebsd8'。除非需要檢測特定版本的系統(tǒng)，否則建議使用以下習慣用法:

if sys.platform.startswith('freebsd'):
    # FreeBSD-specific code here...
elif sys.platform.startswith('linux'):
    # Linux-specific code here...
elif sys.platform.startswith('aix'):
    # AIX-specific code here...

對于其他系統(tǒng)，值是：

系統(tǒng)	平臺 值
AIX	'aix'
Emscripten	'emscripten'
Linux	'linux'
WASI	'wasi'
Windows	'win32'
Windows/Cygwin	'cygwin'
macOS	'darwin'

在 3.3 版更改: 在 Linux 上，sys.platform 將不再包含副版本號。它將總是 'linux' 而不是 'linux2' 或 'linux3'。由于舊版本的 Python 會包含該版本號，因此推薦總是使用上述 startswith 習慣用法。

在 3.8 版更改: 在 AIX 上，sys.platform 將不再包含副版本號。它將總是 'aix' 而不是 'aix5' 或 'aix7'。由于舊版本的 Python 會包含該版本號，因此推薦總是使用上述 startswith 習慣用法。

參見

os.name 更加簡略。os.uname() 提供系統(tǒng)的版本信息。

platform 模塊對系統(tǒng)的標識有更詳細的檢查。

sys.platlibdir?

平臺專用庫目錄。用于構建標準庫的路徑和已安裝擴展模塊的路徑。

在大多數(shù)平臺上，它等同于 "lib" 。在 Fedora 和 SuSE 上，它等同于給出了以下 sys.path 路徑的 64 位平臺上的 "lib64" （其中 X.Y 是 Python 的 major.minor 版本）。

• /usr/lib64/pythonX.Y/：標準庫（如 os 模塊的 os.py ）

• /usr/lib64/pythonX.Y/lib-dynload/：標準庫的 C 擴展模塊（如 errno 模塊，確切的文件名取決于平臺）

• /usr/lib/pythonX.Y/site-packages/ (請使用 lib, 而非 sys.platlibdir): 第三方模塊

• /usr/lib64/pythonX.Y/site-packages/: 第三方包的 C 擴展模塊

3.9 新版功能.

sys.prefix?

A string giving the site-specific directory prefix where the platform independent Python files are installed; on Unix, the default is '/usr/local'. This can be set at build time with the --prefix argument to the configure script. See 安裝路徑 for derived paths.

備注

如果在一個 虛擬環(huán)境 中，那么該值將在 site.py 中被修改，指向虛擬環(huán)境。Python 安裝位置仍然可以用 base_prefix 來獲取。

sys.ps1?

sys.ps2?

字符串，指定解釋器的首要和次要提示符。僅當解釋器處于交互模式時，它們才有定義。這種情況下，它們的初值為 '>>> ' 和 '... '。如果賦給其中某個變量的是非字符串對象，則每次解釋器準備讀取新的交互式命令時，都會重新運行該對象的 str()，這可以用來實現(xiàn)動態(tài)的提示符。

sys.setdlopenflags(n)?

設置解釋器在調用 dlopen() 時用到的標志，例如解釋器在加載擴展模塊時。首先，調用 sys.setdlopenflags(0) 將在導入模塊時對符號啟用惰性解析。要在擴展模塊之間共享符號，請調用 sys.setdlopenflags(os.RTLD_GLOBAL)。標志值的符號名稱可以在 os 模塊中找到（即 RTLD_xxx 常量，如 os.RTLD_LAZY ）。

可用性: Unix。

sys.setprofile(profilefunc)?

設置系統(tǒng)的性能分析函數(shù)，該函數(shù)使得在 Py??thon 中能夠實現(xiàn)一個 Python 源代碼性能分析器。關于 Python Profiler 的更多信息請參閱 Python Profilers 分析器 章節(jié)。性能分析函數(shù)的調用方式類似于系統(tǒng)的跟蹤函數(shù)（參閱 settrace() ），但它是通過不同的事件調用的，例如，不是每執(zhí)行一行代碼就調用它一次（僅在調用某函數(shù)和從某函數(shù)返回時才會調用性能分析函數(shù)，但即使某函數(shù)發(fā)生異常也會算作返回事件）。該函數(shù)是特定于單個線程的，但是性能分析器無法得知線程之間的上下文切換，因此在存在多個線程的情況下使用它是沒有意義的。另外，因為它的返回值不會被用到，所以可以簡單地返回 None。性能分析函數(shù)中的錯誤將導致其自身被解除設置。

性能分析函數(shù)應接收三個參數(shù)：frame、event 和 arg。frame 是當前的堆棧幀。event 是一個字符串：'call'、'return'、'c_call'、'c_return' 或 'c_exception'。arg 取決于事件類型。

引發(fā)一個 審計事件 sys.setprofile，不附帶任何參數(shù)。

這些事件具有以下含義：

'call'

表示調用了某個函數(shù)（或進入了其他的代碼塊）。性能分析函數(shù)將被調用，arg 為 None。

'return'

表示某個函數(shù)（或別的代碼塊）即將返回。性能分析函數(shù)將被調用，arg 是即將返回的值，如果此次返回事件是由于拋出異常，arg 為 None。

'c_call'

表示即將調用某個 C 函數(shù)。它可能是擴展函數(shù)或是內建函數(shù)。arg 是 C 函數(shù)對象。

'c_return'

表示返回了某個 C 函數(shù)。arg 是 C 函數(shù)對象。

'c_exception'

表示某個 C 函數(shù)拋出了異常。arg 是 C 函數(shù)對象。

sys.setrecursionlimit(limit)?

將 Python 解釋器堆棧的最大深度設置為 limit。此限制可防止無限遞歸導致的 C 堆棧溢出和 Python 崩潰。

不同平臺所允許的最高限值不同。當用戶有需要深度遞歸的程序且平臺支持更高的限值，可能就需要調高限值。進行該操作需要謹慎，因為過高的限值可能會導致崩潰。

如果新的限值低于當前的遞歸深度，將拋出 RecursionError 異常。

在 3.5.1 版更改: 如果新的限值低于當前的遞歸深度，現(xiàn)在將拋出 RecursionError 異常。

sys.setswitchinterval(interval)?

設置解釋器的線程切換間隔時間（單位為秒）。該浮點數(shù)決定了“時間片”的理想持續(xù)時間，時間片將分配給同時運行的 Python 線程。請注意，實際值可能更高，尤其是使用了運行時間長的內部函數(shù)或方法時。同時，在時間間隔末尾調度哪個線程是操作系統(tǒng)的決定。解釋器沒有自己的調度程序。

3.2 新版功能.

sys.settrace(tracefunc)?

設置系統(tǒng)的跟蹤函數(shù)，使得用戶在 Python 中就可以實現(xiàn) Python 源代碼調試器。該函數(shù)是特定于單個線程的，所以要讓調試器支持多線程，必須為正在調試的每個線程都用 settrace() 注冊一個跟蹤函數(shù)，或使用 threading.settrace()。

跟蹤函數(shù)應接收三個參數(shù)：frame、event 和 arg。frame 是當前的堆棧幀。event 是一個字符串：'call'、'line'、'return'、'exception' 或 'opcode'。arg 取決于事件類型。

每次進入 trace 函數(shù)的新的局部作用范圍，都會調用 trace 函數(shù)（ event 會被設置為 'call' ），它應該返回一個引用，指向即將用在新作用范圍上的局部跟蹤函數(shù)；如果不需要跟蹤當前的作用范圍，則返回 None。

局部跟蹤函數(shù)應返回對自身的引用（或對另一個函數(shù)的引用，用來在其作用范圍內進行進一步的跟蹤），或者返回 None 來停止跟蹤其作用范圍。

如果跟蹤函數(shù)出錯，則該跟蹤函數(shù)將被取消設置，類似于調用 settrace(None)。

這些事件具有以下含義：

'call'

表示調用了某個函數(shù)（或進入了其他的代碼塊）。全局跟蹤函數(shù)將被調用，arg 為 None。返回值將指定局部跟蹤函數(shù)。

'line'

表示解釋器即將執(zhí)行新一行代碼或重新執(zhí)行循環(huán)條件。局部跟蹤函數(shù)將被調用，arg 為 None，其返回值將指定新的局部跟蹤函數(shù)。關于其工作原理的詳細說明，請參見 Objects/lnotab_notes.txt。要在該堆棧幀禁用每行觸發(fā)事件，可以在堆棧幀上將 f_trace_lines 設置為 False。

'return'

表示某個函數(shù)（或別的代碼塊）即將返回。局部跟蹤函數(shù)將被調用，arg 是即將返回的值，如果此次返回事件是由于拋出異常，arg 為 None。跟蹤函數(shù)的返回值將被忽略。

'exception'

表示發(fā)生了某個異常。局部跟蹤函數(shù)將被調用，arg 是一個 (exception, value, traceback) 元組，返回值將指定新的局部跟蹤函數(shù)。

'opcode'

表示解釋器即將執(zhí)行一個新的操作碼（操作碼的詳情請參閱 dis ）。局部跟蹤函數(shù)將被調用，arg 為 None，其返回值將指定新的局部跟蹤函數(shù)。每操作碼觸發(fā)事件默認情況下都不發(fā)出：必須在堆棧幀上將 f_trace_opcodes 顯式地設置為 True 來請求這些事件。

注意，由于異常是在鏈式調用中傳播的，所以每一級都會產(chǎn)生一個 'exception' 事件。

更細微的用法是，可以顯式地通過賦值 frame.f_trace = tracefunc 來設置跟蹤函數(shù)，而不是用現(xiàn)有跟蹤函數(shù)的返回值去間接設置它。當前幀上的跟蹤函數(shù)必須激活，而 settrace() 還沒有做這件事。注意，為了使上述設置起效，必須使用 settrace() 來安裝全局跟蹤函數(shù)才能啟用運行時跟蹤機制，但是它不必與上述是同一個跟蹤函數(shù)（它可以是一個開銷很低的跟蹤函數(shù)，只返回 None，即在各個幀上立即將其自身禁用）。

關于代碼對象和幀對象的更多信息請參考 標準類型層級結構。

引發(fā)一個 審計事件 sys.settrace，不附帶任何參數(shù)。

CPython implementation detail: settrace() 函數(shù)僅用于實現(xiàn)調試器，性能分析器，打包工具等。它的行為是實現(xiàn)平臺的一部分，而不是語言定義的一部分，因此并非在所有 Python 實現(xiàn)中都可用。

在 3.7 版更改: 添加了 'opcode' 事件類型；為幀對象添加了 f_trace_lines 和 f_trace_opcodes 屬性

sys.set_asyncgen_hooks(firstiter, finalizer)?

接受兩個可選的關鍵字參數(shù)，要求它們是可調用對象，且接受一個 異步生成器迭代器 作為參數(shù)。firstiter 對象將在異步生成器第一次迭代時調用。finalizer 將在異步生成器即將被銷毀時調用。

引發(fā)一個 審計事件 sys.set_asyncgen_hooks_firstiter，不附帶任何參數(shù)。

引發(fā)一個 審計事件 sys.set_asyncgen_hooks_finalizer，不附帶任何參數(shù)。

之所以會引發(fā)兩個審計事件，是因為底層的 API 由兩個調用組成，每個調用都須要引發(fā)自己的事件。

3.6 新版功能: 更多詳情請參閱 PEP 525，finalizer 方法的參考示例可參閱 Lib/asyncio/base_events.py 中 asyncio.Loop.shutdown_asyncgens 的實現(xiàn)。

備注

本函數(shù)已添加至暫定軟件包（詳情請參閱 PEP 411 ）。

sys.set_coroutine_origin_tracking_depth(depth)?

用于啟用或禁用協(xié)程溯源。啟用后，協(xié)程對象上的 cr_origin 屬性將包含一個元組，它由多個（文件名 filename，行號 line number，函數(shù)名 function name）元組組成，整個元組描述出了協(xié)程對象創(chuàng)建過程的回溯，元組首端是最近一次的調用。禁用后，cr_origin 將為 None。

要啟用，請向 depth 傳遞一個大于零的值，它指定了有多少幀將被捕獲信息。要禁用，請將 depth 置為零。

該設置是特定于單個線程的。

3.7 新版功能.

備注

本函數(shù)已添加至暫定軟件包（詳情請參閱 PEP 411 ）。僅將其用于調試目的。

sys._enablelegacywindowsfsencoding()?

將 filesystem encoding and error handler 分別修改為 'mbcs' 和 'replace'，以便與 3.6 之前版本的 Python 保持一致。

這等同于在啟動 Python 前先定義好 PYTHONLEGACYWINDOWSFSENCODING 環(huán)境變量。

另請參閱 sys.getfilesystemencoding() 和 sys.getfilesystemencodeerrors()。

可用性: Windows。

3.6 新版功能: 更多詳情請參閱 PEP 529。

sys.stdin?

sys.stdout?

sys.stderr?

解釋器用于標準輸入、標準輸出和標準錯誤的 文件對象：

• stdin 用于所有交互式輸入（包括對 input() 的調用）；

• stdout 用于 print() 和 expression 語句的輸出，以及用于 input() 的提示符；

• 解釋器自身的提示符和它的錯誤消息都發(fā)往 stderr。

這些流都是常規(guī) 文本文件，與 open() 函數(shù)返回的對象一致。它們的參數(shù)選擇如下：

• 編碼格式和錯誤處理句柄是由 PyConfig.stdio_encoding 和 PyConfig.stdio_errors 來初始化的。

  在 Windows 上，控制臺設備使用 UTF-8。 非字符設備如磁盤文件和管道使用系統(tǒng)語言區(qū)域編碼格式（例如 ANSI 代碼頁）。 非控制臺字符設備如 NUL（例如當 isatty() 返回 True 時）會在啟動時分別讓 stdin 和 stdout/stderr 使用控制臺輸入和輸出代碼頁。 如果進程初始化時沒有被附加到控制臺則會使用默認的系統(tǒng) locale encoding。

  要重寫控制臺的特殊行為，可以在啟動 Python 前設置 PYTHONLEGACYWINDOWSSTDIO 環(huán)境變量。此時，控制臺代碼頁將用于其他字符設備。

  在所有平臺上，都可以通過在 Python 啟動前設置 PYTHONIOENCODING 環(huán)境變量來重寫字符編碼，或通過新的 -X utf8 命令行選項和 PYTHONUTF8 環(huán)境變量來設置。但是，對 Windows 控制臺來說，上述方法僅在設置了 PYTHONLEGACYWINDOWSSTDIO 后才起效。

• 交互模式下，stdout 流是行緩沖的。其他情況下，它像常規(guī)文本文件一樣是塊緩沖的。兩種情況下的 stderr 流都是行緩沖的。要使得兩個流都變成無緩沖，可以傳入 -u 命令行選項或設置 PYTHONUNBUFFERED 環(huán)境變量。

在 3.9 版更改: 非交互模式下，stderr 現(xiàn)在是行緩沖的，而不是全緩沖的。

備注

要從標準流寫入或讀取二進制數(shù)據(jù)，請使用底層二進制 buffer 對象。例如，要將字節(jié)寫入 stdout，請使用 sys.stdout.buffer.write(b'abc')。

但是，如果你在寫一個庫（并且不限制執(zhí)行庫代碼時的上下文），那么請注意，標準流可能會被替換為文件類對象，如 io.StringIO，它們是不支持 buffer 屬性的。

sys.__stdin__?

sys.__stdout__?

sys.__stderr__?

程序開始時，這些對象存有 stdin、stderr 和 stdout 的初始值。它們在程序結束前都可以使用，且在需要向實際的標準流打印內容時很有用，無論 sys.std* 對象是否已重定向。

如果實際文件已經(jīng)被覆蓋成一個損壞的對象了，那它也可用于將實際文件還原成能正常工作的文件對象。但是，本過程的最佳方法應該是，在原來的流被替換之前就顯式地保存它，并使用這一保存的對象來還原。

備注

某些情況下的 stdin、stdout 和 stderr 以及初始值 __stdin__、__stdout__ 和 __stderr__ 可以是 None。通常發(fā)生在未連接到控制臺的 Windows GUI app 中，以及在用 pythonw 啟動的 Python app 中。

sys.stdlib_module_names?

一個包含標準庫模組名稱字符串的凍結集合。

它在所有平臺上都保持一致。 在某些平臺上不可用的模塊和在 Python 編譯時被禁用的模塊也會被列出。 所有種類的模塊都會被列出：純 Python 模塊、內置模塊、凍結模塊和擴展模塊等。 測試模塊則會被排除掉。

對于包來說，僅會列出主包：子包和子模塊不會被列出。 例如，email 包會被列出，但 email.mime 子包和 email.message 子模塊不會被列出。

另請參閱 sys.builtin_module_names 列表。

3.10 新版功能.

sys.thread_info?

一個 具名元組，包含線程實現(xiàn)的信息。

屬性	說明
name	線程實現(xiàn)的名稱： 'nt': Windows 線程 'pthread': POSIX 線程 'solaris': Solaris 線程
lock	鎖實現(xiàn)的名稱： 'semaphore': 鎖使用信號量 'mutex+cond': 鎖使用互斥和條件變量 None 如果此信息未知
version	線程庫的名稱和版本。它是一個字符串，如果此信息未知，則為 None 。

3.3 新版功能.

sys.tracebacklimit?

當該變量值設置為整數(shù)，在發(fā)生未處理的異常時，它將決定打印的回溯信息的最大層級數(shù)。默認為 1000。當將其設置為 0 或小于 0，將關閉所有回溯信息，并且只打印異常類型和異常值。

sys.unraisablehook(unraisable, /)?

處理一個無法拋出的異常。

它會在發(fā)生了一個異常但 Python 沒有辦法處理時被調用。例如，當一個析構器引發(fā)了異常，或在垃圾回收 (gc.collect()) 期間引發(fā)了異常。

unraisable 參數(shù)具有以下屬性:

• exc_type: 異常類型

• exc_value: 異常值，可以是 None.

• exc_traceback: 異?；厮?，可以是 None.

• err_msg: 錯誤信息，可以是 None.

• object: 導致異常的對象，可以為 None.

默認的鉤子程序會將 err_msg 和 object 格式化為： f'{err_msg}: {object!r}'；如果 err_msg 為 None 則采用 "Exception ignored in" 錯誤信息。

要改變無法拋出的異常的處理過程，可以重寫 sys.unraisablehook()。

使用定制鉤子存放 exc_value 可能會創(chuàng)建引用循環(huán)。 它應當在不再需要異常時被顯式地清空以打破引用循環(huán)。

如果一個 object 正在被銷毀，那么使用自定義的鉤子儲存該對象可能會將其復活。請在自定義鉤子生效后避免儲存 object，以避免對象的復活。

另請參閱 excepthook()，它處理未捕獲的異常。

引發(fā)一個審計事件 sys.unraisablehook 并附帶參數(shù) hook, unraisable。

3.8 新版功能.

sys.version?

一個包含 Python 解釋器版本號加編譯版本號以及所用編譯器等額外信息的字符串。 此字符串會在交互式解釋器啟動時顯示。 請不要從中提取版本信息，而應當使用 version_info 以及 platform 模塊所提供的函數(shù)。

sys.api_version?

這個解釋器的 C API 版本。當你在調試 Python及期擴展模板的版本沖突這個功能非常有用。

sys.version_info?

一個包含版本號五部分的元組: major, minor, micro, releaselevel 和 serial。 除 releaselevel 外的所有值均為整數(shù)；發(fā)布級別值則為 'alpha', 'beta', 'candidate' 或 'final'。 對應于 Python 版本 2.0 的 version_info 值為 (2, 0, 0, 'final', 0)。 這些部分也可按名稱訪問，因此 sys.version_info[0] 就等價于 sys.version_info.major，依此類推。

在 3.1 版更改: 增加了以名稱表示的各部分屬性。

sys.warnoptions?

這是警告框架的一個實現(xiàn)細節(jié)；請不要修改此值。 有關警告框架的更多信息請參閱 warnings 模塊。

sys.winver?

用于在 Windows 平臺上組成注冊表鍵的版本號。 這在 Python DLL 中存儲為 1000 號字符串資源。 其值通常是 version 的頭三個字符。 它在 sys 模塊中提供是為了信息展示目的；修改此值不會影響 Python 所使用的注冊表鍵。

可用性: Windows。

sys._xoptions?

一個字典，包含通過 -X 命令行選項傳遞的旗標，這些旗標專屬于各種具體實現(xiàn)。選項名稱將會映射到對應的值（如果顯式指定）或者 True。例如:

$ ./python -Xpycache_prefix=some_path -Xdev
Python 3.2a3+ (py3k, Oct 16 2010, 20:14:50)
[GCC 4.4.3] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import sys
>>> sys._xoptions
{'pycache_prefix': 'some_path', 'dev': True}

CPython implementation detail: 這是 CPython 專屬的訪問通過 -X 傳遞的選項的方式。 其他實現(xiàn)可能會通過其他方式導出它們，或者完全不導出。

3.2 新版功能.

引用

C99

ISO/IEC 9899:1999. "Programming languages -- C." 該標準的公開草案可從 http://www.open-std.org/jtc1/sc22/wg14/www/docs/n1256.pdf獲得。