Python 3.8 有什么新變化?

賦值表達式?

新增的語法 := 可在表達式內(nèi)部為變量賦值。 它被昵稱為“海象運算符”因為它很像是 海象的眼睛和長牙。

在這個示例中，賦值表達式可以避免調(diào)用 len() 兩次:

if (n := len(a)) > 10:
    print(f"List is too long ({n} elements, expected <= 10)")

類似的益處還可出現(xiàn)在正則表達式匹配中需要使用兩次匹配對象的情況中，一次檢測用于匹配是否發(fā)生，另一次用于提取子分組:

discount = 0.0
if (mo := re.search(r'(\d+)% discount', advertisement)):
    discount = float(mo.group(1)) / 100.0

此運算符也適用于配合 while 循環(huán)計算一個值來檢測循環(huán)是否終止，而同一個值又在循環(huán)體中再次被使用的情況:

# Loop over fixed length blocks
while (block := f.read(256)) != '':
    process(block)

另一個值得介紹的用例出現(xiàn)于列表推導(dǎo)式中，在篩選條件中計算一個值，而同一個值又在表達式中需要被使用:

[clean_name.title() for name in names
 if (clean_name := normalize('NFC', name)) in allowed_names]

請盡量將海象運算符的使用限制在清晰的場合中，以降低復(fù)雜性并提升可讀性。

請參閱 PEP 572 了解詳情。

（由 Morehouse 在 bpo-35224 中貢獻。）

僅限位置形參?

新增了一個函數(shù)形參語法 / 用來指明某些函數(shù)形參必須使用僅限位置而非關(guān)鍵字參數(shù)的形式。 這種標記語法與通過 help() 所顯示的使用 Larry Hastings 的 Argument Clinic 工具標記的 C 函數(shù)相同。

在下面的例子中，形參 a 和 b 為僅限位置形參，c 或 d 可以是位置形參或關(guān)鍵字形參，而 e 或 f 要求為關(guān)鍵字形參:

def f(a, b, /, c, d, *, e, f):
    print(a, b, c, d, e, f)

以下均為合法的調(diào)用:

f(10, 20, 30, d=40, e=50, f=60)

但是，以下均為不合法的調(diào)用:

f(10, b=20, c=30, d=40, e=50, f=60)   # b cannot be a keyword argument
f(10, 20, 30, 40, 50, f=60)           # e must be a keyword argument

這種標記形式的一個用例是它允許純 Python 函數(shù)完整模擬現(xiàn)有的用 C 代碼編寫的函數(shù)的行為。 例如，內(nèi)置的 divmod() 函數(shù)不接受關(guān)鍵字參數(shù):

def divmod(a, b, /):
    "Emulate the built in divmod() function"
    return (a // b, a % b)

另一個用例是在不需要形參名稱時排除關(guān)鍵字參數(shù)。 例如，內(nèi)置的 len() 函數(shù)的簽名為 len(obj, /)。 這可以排除如下這種笨拙的調(diào)用形式:

len(obj='hello')  # The "obj" keyword argument impairs readability

另一個益處是將形參標記為僅限位置形參將允許在未來修改形參名而不會破壞客戶的代碼。 例如，在 statistics 模塊中，形參名 dist 在未來可能被修改。 這使得以下函數(shù)描述成為可能:

def quantiles(dist, /, *, n=4, method='exclusive')
    ...

由于在 / 左側(cè)的形參不會被公開為可用關(guān)鍵字，其他形參名仍可在 **kwargs 中使用:

>>> def f(a, b, /, **kwargs):
...     print(a, b, kwargs)
...
>>> f(10, 20, a=1, b=2, c=3)         # a and b are used in two ways
10 20 {'a': 1, 'b': 2, 'c': 3}

這極大地簡化了需要接受任意關(guān)鍵字參數(shù)的函數(shù)和方法的實現(xiàn)。 例如，以下是一段摘自 collections 模塊的代碼:

class Counter(dict):

    def __init__(self, iterable=None, /, **kwds):
        # Note "iterable" is a possible keyword argument

請參閱 PEP 570 了解詳情。

（由 Pablo Galindo 在 bpo-36540 中貢獻。）

用于已編譯字節(jié)碼文件的并行文件系統(tǒng)緩存?

新增的 PYTHONPYCACHEPREFIX 設(shè)置 (也可使用 -X pycache_prefix) 可將隱式的字節(jié)碼緩存配置為使用單獨的并行文件系統(tǒng)樹，而不是默認的每個源代碼目錄下的 __pycache__ 子目錄。

緩存的位置會在 sys.pycache_prefix 中報告 (None 表示默認位置即 __pycache__ 子目錄)。

（由 Carl Meyer 在 bpo-33499 中貢獻。）

調(diào)試構(gòu)建使用與發(fā)布構(gòu)建相同的 ABI?

Python 現(xiàn)在不論是以發(fā)布模式還是調(diào)試模式進行構(gòu)建都將使用相同的 ABI。 在 Unix 上，當(dāng) Python 以調(diào)試模式構(gòu)建時，現(xiàn)在將可以加載以發(fā)布模式構(gòu)建的 C 擴展和使用穩(wěn)定版 ABI 構(gòu)建的 C 擴展。

發(fā)布編譯版和 調(diào)試編譯版 現(xiàn)在都是 ABI 兼容的：定義 Py_DEBUG 宏不會再應(yīng)用 Py_TRACE_REFS 宏，它引入 了唯一的 ABI 不兼容性。 Py_TRACE_REFS 宏添加了 sys.getobjects() 函數(shù)和 PYTHONDUMPREFS 環(huán)境變量，它可以使用新的 ./configure --with-trace-refs 編譯選項來設(shè)置。 （由 Victor Stinner 在 bpo-36465 中貢獻。）

在 Unix 上，C 擴展不會再被鏈接到 libpython，但 Android 和 Cygwin 例外。 現(xiàn)在靜態(tài)鏈接的 Python 將可以加載使用共享庫 Python 構(gòu)建的 C 擴展。 （由 Victor Stinner 在 bpo-21536 中貢獻。）

在 Unix 上，當(dāng) Python 以調(diào)試模式構(gòu)建時，導(dǎo)入操作現(xiàn)在也會查找在發(fā)布模式下編譯的 C 擴展以及使用穩(wěn)定版 ABI 編譯的 C 擴展。 （由 Victor Stinner 在 bpo-36722 中貢獻。）

要將 Python 嵌入到一個應(yīng)用中，必須將新增的 --embed 選項傳給 python3-config --libs --embed 以獲得 -lpython3.8 (將應(yīng)用鏈接到 libpython)。 要同時支持 3.8 和舊版本，請先嘗試 python3-config --libs --embed 并在此命令失敗時回退到 python3-config --libs (即不帶 --embed)。

增加一個 pkg-config python-3.8-embed 模塊用來將 Python 嵌入到一個應(yīng)用中: pkg-config python-3.8-embed --libs 包含 -lpython3.8。 要同時支持 3.8 和舊版本，請先嘗試 pkg-config python-X.Y-embed --libs 并在此命令失敗時回退到 pkg-config python-X.Y --libs (即不帶 --embed) （請將 X.Y 替換為 Python 版本號）。

另一方面，pkg-config python3.8 --libs 不再包含 -lpython3.8。 C 擴展不可被鏈接到 libpython (但 Android 和 Cygwin 例外，這兩者的情況由腳本處理)；此改變是故意被設(shè)為向下不兼容的。 （由 Victor Stinner 在 bpo-36721 中貢獻。）

f-字符串支持 = 用于自動記錄表達式和調(diào)試文檔?

增加 = 說明符用于 f-string。 形式為 f'{expr=}' 的 f-字符串將擴展表示為表達式文本，加一個等于號，再加表達式的求值結(jié)果。 例如：

>>> user = 'eric_idle'
>>> member_since = date(1975, 7, 31)
>>> f'{user=} {member_since=}'
"user='eric_idle' member_since=datetime.date(1975, 7, 31)"

通常的 f-字符串格式說明符 允許更細致地控制所要顯示的表達式結(jié)果:

>>> delta = date.today() - member_since
>>> f'{user=!s}  {delta.days=:,d}'
'user=eric_idle  delta.days=16,075'

= 說明符將輸出整個表達式，以便詳細演示計算過程:

>>> print(f'{theta=}  {cos(radians(theta))=:.3f}')
theta=30  cos(radians(theta))=0.866

（由 Eric V. Smith 和 Larry Hastings 在 bpo-36817 中貢獻。）

PEP 578: Python 運行時審核鉤子?

此 PEP 添加了審核鉤子和已驗證開放鉤子。 兩者在 Python 與本機代碼中均可用。允許以純 Python 代碼編寫的應(yīng)用和框架利用額外的通知，同時允許嵌入開發(fā)人員或系統(tǒng)管理員部署始終啟用審核的 Python 版本。

請參閱 PEP 578 了解詳情。

PEP 587: Python 初始化配置?

PEP 587 增加了一個新的 C API 用來配置 Python 初始化，提供對整個配置過程的更細致控制以及更好的錯誤報告。

新的結(jié)構(gòu)：

• PyConfig

• PyPreConfig

• PyStatus

• PyWideStringList

新的函數(shù)：

• PyConfig_Clear()

• PyConfig_InitIsolatedConfig()

• PyConfig_InitPythonConfig()

• PyConfig_Read()

• PyConfig_SetArgv()

• PyConfig_SetBytesArgv()

• PyConfig_SetBytesString()

• PyConfig_SetString()

• PyPreConfig_InitIsolatedConfig()

• PyPreConfig_InitPythonConfig()

• PyStatus_Error()

• PyStatus_Exception()

• PyStatus_Exit()

• PyStatus_IsError()

• PyStatus_IsExit()

• PyStatus_NoMemory()

• PyStatus_Ok()

• PyWideStringList_Append()

• PyWideStringList_Insert()

• Py_BytesMain()

• Py_ExitStatusException()

• Py_InitializeFromConfig()

• Py_PreInitialize()

• Py_PreInitializeFromArgs()

• Py_PreInitializeFromBytesArgs()

• Py_RunMain()

此 PEP 還為這些內(nèi)部結(jié)構(gòu)添加了 _PyRuntimeState.preconfig (PyPreConfig 類型) 和 PyInterpreterState.config (PyConfig 類型) 字段。 PyInterpreterState.config 成為新的引用配置，替代全局配置變量和其他私有變量。

請參閱 Python 初始化配置 獲取詳細文檔。

請參閱 PEP 587 了解詳情。

（由 Victor Stinner 在 bpo-36763 中貢獻。）

PEP 590: Vectorcall: 用于 CPython 的快速調(diào)用協(xié)議?

將 Vectorcall 協(xié)議 添加到 Python/C API。 它的目標是對已被應(yīng)用于多個類的現(xiàn)有優(yōu)先進行正式化。 任何實現(xiàn)了可調(diào)用對象的 靜態(tài)類型 均可使用此協(xié)議。

此特性目前為暫定狀態(tài)，計劃在 Python 3.9 將其完全公開。

請參閱 PEP 590 了解詳情。

（由 Jeroen Demeyer, Mark Shannon 和 Petr Viktorin 在 bpo-36974 中貢獻。）

具有外部數(shù)據(jù)緩沖區(qū)的 pickle 協(xié)議 5?

當(dāng)使用 pickle 在 Python 進程間傳輸大量數(shù)據(jù)以充分發(fā)揮多核或多機處理的優(yōu)勢時，非常重要一點是通過減少內(nèi)存拷貝來優(yōu)化傳輸效率，并可能應(yīng)用一些定制技巧例如針對特定數(shù)據(jù)的壓縮。

pickle 協(xié)議 5 引入了對于外部緩沖區(qū)的支持，這樣 PEP 3118 兼容的數(shù)據(jù)可以與主 pickle 流分開進行傳輸，這是由通信層來確定的。

請參閱 PEP 574 了解詳情。

（由 Antoine Pitrou 在 bpo-36785 中貢獻。）

ast?

AST 節(jié)點現(xiàn)在具有 end_lineno 和 end_col_offset 屬性，它們給出節(jié)點結(jié)束的精確位置。 （這只適用于具有 lineno 和 col_offset 屬性的節(jié)點。）

新增函數(shù) ast.get_source_segment() 返回指定 AST 節(jié)點的源代碼。

（由 Ivan Levkivskyi 在 bpo-33416 中貢獻。）

ast.parse() 函數(shù)具有一些新的旗標：

• type_comments=True 導(dǎo)致其返回與特定 AST 節(jié)點相關(guān)聯(lián)的 PEP 484 和 PEP 526 類型注釋文本；

• mode='func_type' 可被用于解析 PEP 484 "簽名類型注釋" (為函數(shù)定義 AST 節(jié)點而返回)；

• feature_version=(3, N) 允許指定一個更早的 Python 3 版本。 例如，feature_version=(3, 4) 將把 async 和 await 視為非保留字。

（由 Guido van Rossum 在 bpo-35766 中貢獻。）

asyncio?

asyncio.run() 已經(jīng)從暫定狀態(tài)晉級為穩(wěn)定 API。 此函數(shù)可被用于執(zhí)行一個 coroutine 并返回結(jié)果，同時自動管理事件循環(huán)。 例如:

import asyncio

async def main():
    await asyncio.sleep(0)
    return 42

asyncio.run(main())

這 大致 等價于:

import asyncio

async def main():
    await asyncio.sleep(0)
    return 42

loop = asyncio.new_event_loop()
asyncio.set_event_loop(loop)
try:
    loop.run_until_complete(main())
finally:
    asyncio.set_event_loop(None)
    loop.close()

實際的實現(xiàn)要更復(fù)雜許多。 因此 asyncio.run() 應(yīng)該作為運行 asyncio 程序的首選方式。

（由 Yury Selivanov 在 bpo-32314 中貢獻。）

運行 python -m asyncio 將啟動一個原生異步 REPL。 這允許快速體驗具有最高層級 await 的代碼。 這時不再需要直接調(diào)用 asyncio.run()，因為此操作會在每次發(fā)起調(diào)用時產(chǎn)生一個新事件循環(huán)：

$ python -m asyncio
asyncio REPL 3.8.0
Use "await" directly instead of "asyncio.run()".
Type "help", "copyright", "credits" or "license" for more information.
>>> import asyncio
>>> await asyncio.sleep(10, result='hello')
hello

（由 Yury Selivanov 在 bpo-37028 中貢獻。）

異常 asyncio.CancelledError 現(xiàn)在繼承自 BaseException 而不是 Exception 并且不再繼承自 concurrent.futures.CancelledError。 （由 Yury Selivanov 在 bpo-32528 中貢獻。）

在 Windows 上，現(xiàn)在默認的事件循環(huán)為 ProactorEventLoop。 （由 Victor Stinner 在 bpo-34687 中貢獻。）

ProactorEventLoop 現(xiàn)在也支持 UDP。 （由 Adam Meily 和 Andrew Svetlov 在 bpo-29883 中貢獻。）

ProactorEventLoop 現(xiàn)在可通過 KeyboardInterrupt ("CTRL+C") 來中斷。 （由 Vladimir Matveev 在 bpo-23057 中貢獻。）

添加了 asyncio.Task.get_coro() 用來獲取 asyncio.Task 中的已包裝協(xié)程。 （由 Alex Gr?nholm 在 bpo-36999 中貢獻。）

asyncio 任務(wù)現(xiàn)在可以被命名，或者是通過將 name 關(guān)鍵字參數(shù)傳給 asyncio.create_task() 或 create_task() 事件循環(huán)方法，或者是通過在任務(wù)對象上調(diào)用 set_name() 方法。 任務(wù)名稱在 asyncio.Task 的 repr() 輸出中可見，并且還可以使用 get_name() 方法來獲取。 （由 Alex Gr?nholm 在 bpo-34270 中貢獻。）

將對 Happy Eyeballs 的支持添加到 asyncio.loop.create_connection()。 要指定此行為，已增加了兩個新的形參: happy_eyeballs_delay 和 interleave。 Happy Eyeballs 算法可提升支持 IPv4 和 IPv6 的應(yīng)用的響應(yīng)速度，具體做法是嘗試同時使用兩者進行連接。 （由 twisteroid ambassador 在 bpo-33530 中貢獻。）

builtins?

內(nèi)置的 compile() 已改進為可接受 ast.PyCF_ALLOW_TOP_LEVEL_AWAIT 旗標。 當(dāng)傳入此新旗標時，compile() 將允許通常被視為無效語法的最高層級 await, async for 和 async with 構(gòu)造。 此后將可返回帶有 CO_COROUTINE 旗標的異步代碼對象。 （由 Matthias Bussonnier 在 bpo-34616 中貢獻。）

collections?

collections.namedtuple() 的 _asdict() 方法現(xiàn)在將返回 dict 而不是 collections.OrderedDict。 此項更改是由于普通字典自 Python 3.7 起已保證具有確定的元素順序。 如果還需要 OrderedDict 的額外特性，建議的解決方案是將結(jié)果轉(zhuǎn)換為需要的類型: OrderedDict(nt._asdict())。 （由 Raymond Hettinger 在 bpo-35864 中貢獻。）

cProfile?

cProfile.Profile 類現(xiàn)在可被用作上下文管理器。 在運行時對一個代碼塊實現(xiàn)性能分析:

import cProfile

with cProfile.Profile() as profiler:
      # code to be profiled
      ...

（由 Scott Sanderson 在 bpo-29235 中貢獻。）

csv?

csv.DictReader 現(xiàn)在將返回 dict 而不是 collections.OrderedDict。 此工具現(xiàn)在會更快速且消耗更少內(nèi)存同時仍然保留字段順序。 （由 Michael Selik 在 bpo-34003 中貢獻。）

curses?

添加了一個新變量用于保存下層 ncurses 庫的結(jié)構(gòu)版信息: ncurses_version。 （由 Serhiy Storchaka 在 bpo-31680 中貢獻。）

ctypes?

在 Windows 上，CDLL 及其子類現(xiàn)在接受 winmode 形參來指定用于底層 LoadLibraryEx 調(diào)用的旗標。 默認旗標被設(shè)為僅加載來自可信任位置的 DLL 依賴項，包括 DLL 的存放路徑（如果加載初始 DLL 時使用了完整或部分路徑）以及通過 add_dll_directory() 添加的路徑。 （由 Steve Dower 在 bpo-36085 中貢獻。）

datetime?

添加了新的替代構(gòu)造器 datetime.date.fromisocalendar() 和 datetime.datetime.fromisocalendar()，它們分別基于 ISO 年份、周序號和周內(nèi)日序號來構(gòu)造 date 和 datetime 對象；這兩者分別是其所對應(yīng)類中 isocalendar 方法的逆操作。 （由 Paul Ganssle 在 bpo-36004 中貢獻。）

functools?

functools.lru_cache() 現(xiàn)在可直接作為裝飾器而不是作為返回裝飾器的函數(shù)。 因此這兩種寫法現(xiàn)在都被支持:

@lru_cache
def f(x):
    ...

@lru_cache(maxsize=256)
def f(x):
    ...

（由 Raymond Hettinger 在 bpo-36772 中貢獻。）

添加了新的 functools.cached_property() 裝飾器，用于在實例生命周期內(nèi)緩存的已計算特征屬性。

import functools
import statistics

class Dataset:
   def __init__(self, sequence_of_numbers):
      self.data = sequence_of_numbers

   @functools.cached_property
   def variance(self):
      return statistics.variance(self.data)

（由 Carl Meyer 在 bpo-21145 中貢獻）

添加了新的 functools.singledispatchmethod() 裝飾器可使用 single dispatch 將方法轉(zhuǎn)換為 泛型函數(shù):

from functools import singledispatchmethod
from contextlib import suppress

class TaskManager:

    def __init__(self, tasks):
        self.tasks = list(tasks)

    @singledispatchmethod
    def discard(self, value):
        with suppress(ValueError):
            self.tasks.remove(value)

    @discard.register(list)
    def _(self, tasks):
        targets = set(tasks)
        self.tasks = [x for x in self.tasks if x not in targets]

（由 Ethan Smith 在 bpo-32380 中貢獻）

gc?

get_objects() 現(xiàn)在能接受一個可選的 generation 形參來指定一個用于獲取對象的生成器。 （由 Pablo Galindo 在 bpo-36016 中貢獻。）

gettext?

添加了 pgettext() 及其變化形式。 （由 Franz Glasner, éric Araujo 和 Cheryl Sabella 在 bpo-2504 中貢獻。）

gzip?

添加 mtime 形參到 gzip.compress() 用于可重現(xiàn)的輸出。 （由 Guo Ci Teo 在 bpo-34898 中貢獻。）

對于特定類型的無效或已損壞 gzip 文件現(xiàn)在將引發(fā) BadGzipFile 而不是 OSError。 （由 Filip Gruszczyński, Michele Orrù 和 Zackery Spytz 在 bpo-6584 中貢獻。）

IDLE 與 idlelib?

超過 N 行（默認值為 50）的輸出將被折疊為一個按鈕。 N 可以在 Settings 對話框的 General 頁的 PyShell 部分中進行修改。 數(shù)量較少但是超長的行可以通過在輸出上右擊來折疊。 被折疊的輸出可通過雙擊按鈕來展開，或是通過右擊按鈕來放入剪貼板或是單獨的窗口。 （由 Tal Einat 在 bpo-1529353 中貢獻。）

在 Run 菜單中增加了 "Run Customized" 以使用自定義設(shè)置來運行模塊。 輸入的任何命令行參數(shù)都會被加入 sys.argv。 它們在下次自定義運行時會再次顯示在窗體中。 用戶也可以禁用通常的 Shell 主模塊重啟。 （由 Cheryl Sabella, Terry Jan Reedy 等人在 bpo-5680 和 bpo-37627 中貢獻。）

在 IDLE 編輯器窗口中增加了可選的行號。 窗口打開時默認不顯示行號，除非在配置對話框的 General 選項卡中特別設(shè)置。 已打開窗口中的行號可以在 Options 菜單中顯示和隱藏。 （由 Tal Einat 和 Saimadhav Heblikar 在 bpo-17535 中貢獻。）

現(xiàn)在會使用 OS 本機編碼格式在 Python 字符串和 Tcl 對象間進行轉(zhuǎn)換。 這允許在 IDLE 中處理 emoji 和其他非 BMP 字符。 這些字符將可被顯示或是從剪貼板復(fù)制和粘貼。 字符串從 Tcl 到 Python 的來回轉(zhuǎn)換現(xiàn)在不會再發(fā)生失敗。 （過去八年有許多人都為此付出過努力，問題最終由 Serhiy Storchaka 在 bpo-13153 中解決。）

在 3.8.1 中新增:

添加切換光標閃爍停止的選項。 （由 Zackery Spytz 在 bpo-4603 中貢獻。）

Esc 鍵現(xiàn)在會關(guān)閉 IDLE 補全提示窗口。 （由 Johnny Najera 在 bpo-38944 中貢獻。）

上述修改已被反向移植到 3.7 維護發(fā)行版中。

添加關(guān)鍵字到模塊名稱補全列表。 （由 Terry J. Reedy 在 bpo-37765 中貢獻。）

inspect?

inspect.getdoc() 函數(shù)現(xiàn)在可以找到 __slots__ 的文檔字符串，如果該屬性是一個元素值為文檔字符串的 dict 的話。 這提供了類似于目前已有的 property(), classmethod() 和 staticmethod() 等函數(shù)的文檔選項:

class AudioClip:
    __slots__ = {'bit_rate': 'expressed in kilohertz to one decimal place',
                 'duration': 'in seconds, rounded up to an integer'}
    def __init__(self, bit_rate, duration):
        self.bit_rate = round(bit_rate / 1000.0, 1)
        self.duration = ceil(duration)

（由 Raymond Hettinger 在 bpo-36326 中貢獻。）

io?

在開發(fā)模式 (-X env) 和 調(diào)試編譯版 中，io.IOBase 終結(jié)器現(xiàn)在會在 close() 方法失敗時將異常寫入日志。 發(fā)生的異常在發(fā)布編譯版中會被靜默地忽略。 （由 Victor Stinner 在 bpo-18748 中貢獻。）

itertools?

itertools.accumulate() 函數(shù)增加了可選的 initial 關(guān)鍵字參數(shù)用來指定一個初始值:

>>> from itertools import accumulate
>>> list(accumulate([10, 5, 30, 15], initial=1000))
[1000, 1010, 1015, 1045, 1060]

（由 Lisa Roach 在 bpo-34659 中貢獻。）

json.tool?

添加選項 --json-lines 用于將每個輸入行解析為單獨的 JSON 對象。 （由 Weipeng Hong 在 bpo-31553 中貢獻。）

logging?

為 logging.basicConfig() 添加了 force 關(guān)鍵字參數(shù)，當(dāng)設(shè)為真值時，關(guān)聯(lián)到根日志記錄器的任何現(xiàn)有處理程序都將在執(zhí)行由其他參數(shù)所指定的配置之前被移除并關(guān)閉。

這解決了一個長期存在的問題。 當(dāng)一個日志處理器或 basicConfig() 被調(diào)用時，對 basicConfig() 的后續(xù)調(diào)用會被靜默地忽略。 這導(dǎo)致使用交互提示符或 Jupyter 筆記本更新、試驗或講解各種日志配置選項變得相當(dāng)困難。

（由 Raymond Hettinger 提議，由 Dong-hee Na 實現(xiàn)，并由 Vinay Sajip 在 bpo-33897 中完成審核。）

math?

添加了新的函數(shù) math.dist() 用于計算兩點之間的歐幾里得距離。 （由 Raymond Hettinger 在 bpo-33089 中貢獻。）

擴展了 math.hypot() 函數(shù)以便處理更多的維度。 之前它僅支持 2-D 的情況。 （由 Raymond Hettinger 在 bpo-33089 中貢獻。）

添加了新的函數(shù) math.prod() 作為的 sum() 同類，該函數(shù)返回 'start' 值 (默認值: 1) 乘以一個數(shù)字可迭代對象的積:

>>> prior = 0.8
>>> likelihoods = [0.625, 0.84, 0.30]
>>> math.prod(likelihoods, start=prior)
0.126

（由 Pablo Galindo 在 bpo-35606 中貢獻。）

添加了兩個新的組合函數(shù) math.perm() 和 math.comb():

>>> math.perm(10, 3)    # Permutations of 10 things taken 3 at a time
720
>>> math.comb(10, 3)    # Combinations of 10 things taken 3 at a time
120

（由 Yash Aggarwal, Keller Fuchs, Serhiy Storchaka 和 Raymond Hettinger 在 bpo-37128, bpo-37178 和 bpo-35431 中貢獻。）

添加了一個新函數(shù) math.isqrt() 用于計算精確整數(shù)平方根而無需轉(zhuǎn)換為浮點數(shù)。 該新函數(shù)支持任意大整數(shù)。 它的執(zhí)行速度比 floor(sqrt(n)) 快但是比 math.sqrt() 慢:

>>> r = 650320427
>>> s = r ** 2
>>> isqrt(s - 1)         # correct
650320426
>>> floor(sqrt(s - 1))   # incorrect
650320427

（由 Mark Dickinson 在 bpo-36887 中貢獻。）

函數(shù) math.factorial() 不再接受非整數(shù)類參數(shù)。 （由 Pablo Galindo 在 bpo-33083 中貢獻。）

mmap?

mmap.mmap 類現(xiàn)在具有一個 madvise() 方法用于訪問 madvise() 系統(tǒng)調(diào)用。 （由 Zackery Spytz 在 bpo-32941 中貢獻。）

multiprocessing?

添加了新的 multiprocessing.shared_memory 模塊。 （由 Davin Potts 在 bpo-35813 中貢獻。）

在macOS上，現(xiàn)在默認使用的啟動方式是*spawn*啟動方式。 （由 Victor Stinner 在 bpo-33725 中貢獻。）

os?

在 Windows 上添加了新函數(shù) add_dll_directory() 用于在導(dǎo)入擴展模塊或使用 ctypes 加載 DLL 時為本機依賴提供額外搜索路徑 。 （由 Steve Dower 在 bpo-36085 中貢獻。）

添加了新的 os.memfd_create() 函數(shù)用于包裝 memfd_create() 系統(tǒng)調(diào)用。 （由 Zackery Spytz 和 Christian Heimes 在 bpo-26836 中貢獻。）

在 Windows 上，大部分用于處理重解析點,（包括符號鏈接和目錄連接）的手動邏輯已被委托給操作系統(tǒng)。 特別地，os.stat() 現(xiàn)在將會遍歷操作系統(tǒng)所支持的任何內(nèi)容，而 os.lstat() 將只打開被標識為“名稱代理”的重解析點，而其要由 os.stat() 打開其他的重解析點。 在所有情況下，stat_result.st_mode 將只為符號鏈接而非其他種類的重解析點設(shè)置 S_IFLNK。 要標識其他種類的重解析點，請檢查新的 stat_result.st_reparse_tag 屬性。

在 Windows 上，os.readlink() 現(xiàn)在能夠讀取目錄連接。 請注意 islink() 會對目錄連接返回 False，因此首先檢查 islink 的代碼將連續(xù)把連接視為目錄，而會處理 os.readlink() 所引發(fā)錯誤的代碼現(xiàn)在會把連接視為鏈接。

（由 Steve Dower 在 bpo-37834 中貢獻。）

os.path?

返回布爾值結(jié)果的 os.path 函數(shù)例如 exists(), lexists(), isdir(), isfile(), islink(), 以及 ismount() 現(xiàn)在對于包含在 OS 層級無法表示的字符或字節(jié)的路徑將會返回 False 而不是引發(fā) ValueError 或其子類 UnicodeEncodeError 和 UnicodeDecodeError。 （由 Serhiy Storchaka 在 bpo-33721 中貢獻。）

expanduser() 在 Windows 上現(xiàn)在改用 USERPROFILE 環(huán)境變量而不再使用 HOME，后者通常不會為一般用戶賬戶設(shè)置。 （由 Anthony Sottile 在 bpo-36264 中貢獻。）

isdir() 在 Windows 上將不再為不存在的目錄的鏈接返回 True。

realpath() 在 Windows 上現(xiàn)在會識別重解析點，包括符號鏈接和目錄連接。

（由 Steve Dower 在 bpo-37834 中貢獻。）

pathlib?

返回布爾值結(jié)果的 pathlib.Path 方法例如 exists(), is_dir(), is_file(), is_mount(), is_symlink(), is_block_device(), is_char_device(), is_fifo(), is_socket() 現(xiàn)在對于包含在 OS 層級無法表示的字符或字節(jié)的路徑將會返回 False 而不是引發(fā) ValueError 或其子類 UnicodeEncodeError。 （由 Serhiy Storchaka 在 bpo-33721 中貢獻。）

Added pathlib.Path.link_to() which creates a hard link pointing to a path. (Contributed by Joannah Nanjekye in bpo-26978) Note that link_to was deprecated in 3.10 and removed in 3.12 in favor of a hardlink_to method added in 3.10 which matches the semantics of the existing symlink_to method.

pickle?

pickle 擴展子類化針對 C 優(yōu)化的 Pickler 現(xiàn)在可通過定義特殊的 reducer_override() 方法來重載函數(shù)和類的封存邏輯。 （由 Pierre Glaser 和 Olivier Grisel 在 bpo-35900 中貢獻。）

plistlib?

添加了新的 plistlib.UID 并啟動了對讀取和寫入經(jīng)過 NSKeyedArchiver 編碼的二進制 plists 的支持。 （由 Jon Janzen 在 bpo-26707 中貢獻。）

pprint?

pprint 模塊為一些函數(shù)添加了 sort_dicts 形參。 默認情況下，這些函數(shù)會繼續(xù)在渲染或打印之前對字典進行排序。 但是，如果 sort_dicts 設(shè)為假值，則字典將保持鍵插入時的順序。 這在調(diào)試期間與 JSON 輸入進行比較時會很有用。

除此之外，還增加了一個方便的新函數(shù) pprint.pp()，它類似于 pprint.pprint() 但它的 sort_dicts 默認為 False:

>>> from pprint import pprint, pp
>>> d = dict(source='input.txt', operation='filter', destination='output.txt')
>>> pp(d, width=40)                  # Original order
{'source': 'input.txt',
 'operation': 'filter',
 'destination': 'output.txt'}
>>> pprint(d, width=40)              # Keys sorted alphabetically
{'destination': 'output.txt',
 'operation': 'filter',
 'source': 'input.txt'}

（由 Rémi Lapeyre 在 bpo-30670 中貢獻。）

py_compile?

py_compile.compile() 現(xiàn)在支持靜默模式。 （由 Joannah Nanjekye 在 bpo-22640 中貢獻。）

shlex?

新增了 shlex.join() 函數(shù)作為 shlex.split() 的逆操作。 （由 Bo Bayles 在 bpo-32102 中貢獻。）

shutil?

shutil.copytree() 現(xiàn)在接受新的 dirs_exist_ok 關(guān)鍵字參數(shù)。 （由 Josh Bronson 在 bpo-20849 中貢獻。）

shutil.make_archive() 現(xiàn)在對新的歸檔默認使用 modern pax (POSIX.1-2001) 格式以提升可移植性和標準一致性，此特性繼承自對 tarfile 模塊的相應(yīng)更改。 （由 C.A.M. Gerlach 在 bpo-30661 中貢獻。）

shutil.rmtree() 在 Windows 上現(xiàn)在會移除目錄連接而不會遞歸地先移除其中的內(nèi)容。 （由 Steve Dower 在 bpo-37834 中貢獻。）

socket?

添加了便捷的 create_server() 和 has_dualstack_ipv6() 函數(shù)以自動化在創(chuàng)建服務(wù)器套接字時通常情況下所必須的任務(wù)，包括在同一套接字中同時接受 IPv4 和 IPv6 連接。 （由 Giampaolo Rodolà 在 bpo-17561 中貢獻。）

socket.if_nameindex(), socket.if_nametoindex() 和 socket.if_indextoname() 函數(shù)已經(jīng)在 Windows 上實現(xiàn)。 （由 Zackery Spytz 在 bpo-37007 中貢獻。）

ssl?

增加了 post_handshake_auth 和 verify_client_post_handshake() 分別啟用和初始化 TLS 1.3 握手后驗證。 （由 Christian Heimes 在 bpo-34670 中貢獻。）

statistics?

添加了 statistics.fmean() 作為 statistics.mean() 的更快速的浮點數(shù)版版本。 （由 Raymond Hettinger 和 Steven D'Aprano 在 bpo-35904 中貢獻。）

添加了 statistics.geometric_mean() （由 Raymond Hettinger 在 bpo-27181 中貢獻。）

添加了 statistics.multimode() 用于返回最常見值的列表。 （由 Raymond Hettinger 在 bpo-35892 中貢獻。）

添加了 statistics.quantiles() 用于將數(shù)據(jù)或分布劃分為多個等概率區(qū)間（例如四分位、十分位或百分位）。 （由 Raymond Hettinger 在 bpo-36546 中貢獻。）

添加了 statistics.NormalDist 用于創(chuàng)建和操縱隨機變量的正態(tài)分布。 （由 Raymond Hettinger 在 bpo-36018 中貢獻。）

>>> temperature_feb = NormalDist.from_samples([4, 12, -3, 2, 7, 14])
>>> temperature_feb.mean
6.0
>>> temperature_feb.stdev
6.356099432828281

>>> temperature_feb.cdf(3)            # Chance of being under 3 degrees
0.3184678262814532
>>> # Relative chance of being 7 degrees versus 10 degrees
>>> temperature_feb.pdf(7) / temperature_feb.pdf(10)
1.2039930378537762

>>> el_ni?o = NormalDist(4, 2.5)
>>> temperature_feb += el_ni?o        # Add in a climate effect
>>> temperature_feb
NormalDist(mu=10.0, sigma=6.830080526611674)

>>> temperature_feb * (9/5) + 32      # Convert to Fahrenheit
NormalDist(mu=50.0, sigma=12.294144947901014)
>>> temperature_feb.samples(3)        # Generate random samples
[7.672102882379219, 12.000027119750287, 4.647488369766392]

sys?

添加了新的 sys.unraisablehook() 函數(shù)，可被重載以便控制如何處理“不可引發(fā)的異?！?。 它會在發(fā)生了一個異常但 Python 沒有辦法處理時被調(diào)用。 例如，當(dāng)一個析構(gòu)器在垃圾回收時 (gc.collect()) 所引發(fā)的異常。 （由 Victor Stinner 在 bpo-36829 中貢獻。）

tarfile?

tarfile 模塊現(xiàn)在對新的歸檔默認使用 modern pax (POSIX.1-2001) 格式而不再是之前的 GNU 專屬格式。 這通過標準化和可擴展格式的統(tǒng)一編碼 (UTF-8) 提升了跨平臺可移植性，還提供了其他一些益處。 （由 C.A.M. Gerlach 在 bpo-36268 中貢獻。）

threading?

添加了新的 threading.excepthook() 函數(shù)用來處理未捕獲的 threading.Thread.run() 異常。 它可被重載以便控制如何處理未捕獲的 threading.Thread.run() 異常。 （由 Victor Stinner 在 bpo-1230540 中貢獻。）

添加了新的 threading.get_native_id() 函數(shù)以及 threading.Thread 類的 native_id 屬性。 它們會返回內(nèi)核所分配給當(dāng)前線程的原生整數(shù)線程 ID。 此特性僅在特定平臺上可用，參見 get_native_id 了解詳情。 （由 Jake Tesler 在 bpo-36084 中貢獻。）

tokenize?

當(dāng)提供不帶末尾新行的輸入時，tokenize 模塊現(xiàn)在會隱式地添加 NEWLINE 形符。 此行為現(xiàn)在已與 C 詞法分析器的內(nèi)部行為相匹配。 （由 Ammar Askar 在 bpo-33899 中貢獻。）

tkinter?

在 tkinter.Spinbox 中添加了方法 selection_from(), selection_present(), selection_range() 和 selection_to()。 （由 Juliette Monsel 在 bpo-34829 中貢獻。）

在 tkinter.Canvas 類中添加了方法 moveto()。 （由 Juliette Monsel 在 bpo-23831 中貢獻。）

tkinter.PhotoImage 類現(xiàn)在具有 transparency_get() 和 transparency_set() 方法。 （由 Zackery Spytz 在 bpo-25451 中貢獻。）

time?

為 macOS 10.12 添加了新的時鐘 CLOCK_UPTIME_RAW。 （由 Joannah Nanjekye 在 bpo-35702 中貢獻。）

typing?

typing 模塊加入了一些新特性：

• 一個帶有鍵專屬類型的字典類型。 參見 PEP 589 和 typing.TypedDict。 TypedDict 只使用字符串作為鍵。 默認情況下每個鍵都要求提供。 指定 "total=False" 以允許鍵作為可選項:

  class Location(TypedDict, total=False):
      lat_long: tuple
      grid_square: str
      xy_coordinate: tuple
  

• Literal 類型。 參見 PEP 586 和 typing.Literal。 Literal 類型指明一個形參或返回值被限定為一個或多個特定的字面值:

  def get_status(port: int) -> Literal['connected', 'disconnected']:
      ...
  

• "Final" 變量、函數(shù)、方法和類。 參見 PEP 591, typing.Final 和 typing.final()。 final 限定符會指示靜態(tài)類型檢查器限制進行子類化、重載或重新賦值:

  pi: Final[float] = 3.1415926536
  

• 協(xié)議定義。 參見 PEP 544, typing.Protocol 和 typing.runtime_checkable()。 簡單的 ABC 例如 typing.SupportsInt 現(xiàn)在是 Protocol 的子類。

• 新的協(xié)議類 typing.SupportsIndex。

• 新的函數(shù) typing.get_origin() 和 typing.get_args()。

unicodedata?

unicodedata 模塊現(xiàn)在已升級為使用 Unicode 12.1.0 發(fā)布版。

新的函數(shù) is_normalized() 可被用來驗證字符串是否為特定正規(guī)形式，通常會比實際進行字符串正規(guī)化要快得多。 （由 Max Belanger, David Euresti 和 Greg Price 在 bpo-32285 和 bpo-37966 中貢獻。）

unittest?

添加了 AsyncMock 以支持異步版本的 Mock。 同時也添加了相應(yīng)的斷言函數(shù)用于測試。 （由 Lisa Roach 在 bpo-26467 中貢獻。）

unittest 添加了 addModuleCleanup() 和 addClassCleanup() 以支持對 setUpModule() 和 setUpClass() 進行清理。 （由 Lisa Roach 在 bpo-24412 中貢獻。）

一些模擬斷言函數(shù)現(xiàn)在也會在失敗時打印一個實際調(diào)用列表。 （由 Petter Strandmark 在 bpo-35047 中貢獻。）

unittest 模塊已支持通過 unittest.IsolatedAsyncioTestCase 來使用協(xié)程作為測試用例。 （由 Andrew Svetlov 在 bpo-32972 中貢獻。）

示例:

import unittest


class TestRequest(unittest.IsolatedAsyncioTestCase):

    async def asyncSetUp(self):
        self.connection = await AsyncConnection()

    async def test_get(self):
        response = await self.connection.get("https://example.com")
        self.assertEqual(response.status_code, 200)

    async def asyncTearDown(self):
        await self.connection.close()


if __name__ == "__main__":
    unittest.main()

venv?

現(xiàn)在 venv 在所有平臺上都會包含 Activate.ps1 腳本用于在 PowerShell Core 6.1 下激活虛擬環(huán)境。 （由 Brett Cannon 在 bpo-32718 中貢獻。）

weakref?

由 weakref.proxy() 返回的代理對象現(xiàn)在除其他算術(shù)運算符外也支持矩陣乘法運算符 @ 和 @=。 （由 Mark Dickinson 在 bpo-36669 中貢獻。）

xml?

作為對 DTD 和外部實體檢索的緩解，在默認情況下 xml.dom.minidom 和 xml.sax 模塊不再處理外部實體。 （由 Christian Heimes 在 bpo-17239 中貢獻。）

xml.etree.ElementTree 模塊中的 .find*() 方法支持通配符搜索例如 {*}tag，此搜索會忽略命名空間以及返回給定命名空間中所有標簽的 {namespace}*。 （由 Stefan Behnel 在 bpo-28238 中貢獻。）

xml.etree.ElementTree 模塊提供了實現(xiàn) C14N 2.0 的新函數(shù) –xml.etree.ElementTree.canonicalize()。 （由 Stefan Behnel 在 bpo-13611 中貢獻。）

xml.etree.ElementTree.XMLParser 的目標對象可通過新的回調(diào)方法 start_ns() 和 end_ns() 來接受命名空間聲明事件。 此外，xml.etree.ElementTree.TreeBuilder 目標可被配置為處理有關(guān)注釋和處理指令事件以將它們包含在所生成的樹當(dāng)中。 （由 Stefan Behnel 在 bpo-36676 和 bpo-36673 中貢獻。）

xmlrpc?

xmlrpc.client.ServerProxy 現(xiàn)在支持可選的 headers 關(guān)鍵字參數(shù)作為隨同每次請求發(fā)送的 HTTP 標頭序列。 此特征的作用之一是使得從默認的基礎(chǔ)認證升級到更快速的會話認證成為可能。 （由 Cédric Krier 在 bpo-35153 中貢獻。）

Python 行為的改變?

• yield 表達式（包括 yield 和 yield from 子句）現(xiàn)在不允許在推導(dǎo)式和生成器表達式中使用（但 for 子句最左邊的可迭代對象表達式除外）。 （由 Serhiy Storchaka 在 bpo-10544 中貢獻。）

• 當(dāng)標識號檢測 (is 和 is not) 與特定類型的字面值 (例如字符串和數(shù)字) 一同使用時編譯器現(xiàn)在會產(chǎn)生 SyntaxWarning。 這在 CPython 中通常是可行的，但并不被語言定義所保證。 該警告會建議用戶改用相等性檢測 (== and !=)。 （由 Serhiy Storchaka 在 bpo-34850 中貢獻。）

• CPython 解釋器在某些情況下可以忽略異常。 在 Python 3.8 中這種情況會更少發(fā)生。 特別地，從類型字典獲取屬性時引發(fā)的異常不會再被忽略。 （由 Serhiy Storchaka 在 bpo-35459 中貢獻。）

• 從內(nèi)置類型 bool, int, float, complex 和標準庫的一些類中移除了 __str__ 實現(xiàn)。 它們現(xiàn)在會從 object 繼承 __str__()。 作為結(jié)果，在這些類的子類中定義 __repr__() 方法將會影響它們的字符串表示。 （由 Serhiy Storchaka 在 bpo-36793 中貢獻。）

• 在 AIX 上，sys.platform 將不再包含主要版本號。 它將總是 'aix' 而不再是 'aix3' .. 'aix7'。 由于較舊的 Python 版本會包含該版本號，因此推薦總是使用 sys.platform.startswith('aix')。 （由 M. Felt 在 bpo-36588 中貢獻。）

• 現(xiàn)在 PyEval_AcquireLock() 和 PyEval_AcquireThread() 如果當(dāng)解釋器終結(jié)化時被調(diào)用將會終結(jié)當(dāng)前線程，以使它們與 PyEval_RestoreThread(), Py_END_ALLOW_THREADS() 以及 PyGILState_Ensure() 保持一致。 如果不想要這樣的行為，請通過檢測 _Py_IsFinalizing() 或 sys.is_finalizing() 來保護該調(diào)用。 （由 Joannah Nanjekye 在 bpo-36475 中貢獻。）

Python API 的變化?

• 在 Windows 上 os.getcwdb() 函數(shù)現(xiàn)在會使用 UTF-8 編碼格式而不是 ANSI 代碼頁：請參看 PEP 529 了解具體原因。 該函數(shù)在 Windows 上不再被棄用。 （由 Victor Stinner 在 bpo-37412 中貢獻。）

• 現(xiàn)在 subprocess.Popen 在某些情況下會使用 os.posix_spawn() 以獲得更好的性能。 在適用于 Linux 的 Windows 子系統(tǒng)和 QEMU 用戶模擬器上，使用 os.posix_spawn() 的 Popen 構(gòu)造器不會再因為“找不到程序”這樣的錯誤引發(fā)異常。 而是讓子進程失敗并返回一個非零的 returncode。 （由 Joannah Nanjekye 和 Victor Stinner 在 bpo-35537 中貢獻。）

• The preexec_fn argument of * subprocess.Popen is no longer compatible with subinterpreters. The use of the parameter in a subinterpreter now raises RuntimeError. (Contributed by Eric Snow in bpo-34651, modified by Christian Heimes in bpo-37951.)

• imap.IMAP4.logout() 方法不會再靜默地忽略任意異常。 （由 Victor Stinner 在 bpo-36348 中貢獻。）

• 函數(shù) platform.popen() 已被移除，它自 Python 3.3 起就已被棄用：請改用 os.popen()。 （由 Victor Stinner 在 bpo-35345 中貢獻。）

• 當(dāng)傳入多模數(shù)據(jù)時 statistics.mode() 函數(shù)不會再引發(fā)異常。 它將改為返回在輸入數(shù)據(jù)中遇到的第一個模式。 （由 Raymond Hettinger 在 bpo-35892 中貢獻。）

• tkinter.ttk.Treeview 類的 selection() 方法不再接受參數(shù)。 帶參數(shù)調(diào)用該方法來改變選擇在 Python 3.6 中已棄用。 請使用專門方法例如 selection_set() 來改變選擇。 （由 Serhiy Storchaka 在 bpo-31508 中貢獻。）

• xml.dom.minidom 的 writexml(), toxml() 和 toprettyxml() 方法以及 xml.etree 的 write() 方法現(xiàn)在會保留用戶指定的屬性順序。 （由 Diego Rojas 和 Raymond Hettinger 在 bpo-34160 中貢獻。）

• 附帶 'r' 旗標打開的 dbm.dumb 數(shù)據(jù)庫現(xiàn)在將是只讀的。 如果數(shù)據(jù)庫不存在，附帶 'r' 和 'w' 旗標的 dbm.dumb.open() 不會再創(chuàng)建數(shù)據(jù)庫。 （由 Serhiy Storchaka 在 bpo-32749 中貢獻。）

• 在 XMLParser 的子類中定義的 doctype() 方法將不會再被調(diào)用，并將導(dǎo)致發(fā)出 RuntimeWarning 而不是 DeprecationWarning。 請在目標上定義 doctype() 方法來處理 XML doctype 聲明。 （由 Serhiy Storchaka 在 bpo-29209 中貢獻。）

• 現(xiàn)在當(dāng)自定義元類未在傳給 type.__new__ 的命名空間中提供 __classcell__ 入口時將引發(fā) RuntimeError。 在 Python 3.6--3.7 中是則是引發(fā) DeprecationWarning。 （由 Serhiy Storchaka 在 bpo-23722 中貢獻。）

• cProfile.Profile 類現(xiàn)在可被用作上下文管理器。 （由 Scott Sanderson 在 bpo-29235 中貢獻。）

• shutil.copyfile(), shutil.copy(), shutil.copy2(), shutil.copytree() 和 shutil.move() 會使用平臺專屬的 "fast-copy" 系統(tǒng)調(diào)用（參見 依賴于具體平臺的高效拷貝操作 一節(jié)）。

• shutil.copyfile() 在 Windows 上的默認緩沖區(qū)大小從 16 KiB 改為 1 MiB。

• PyGC_Head 結(jié)構(gòu)已被完全改變。 所有接觸到該結(jié)構(gòu)的代碼都應(yīng)當(dāng)被重寫。 （參見 bpo-33597。）

• PyInterpreterState 結(jié)構(gòu)已被移入 "internal" 頭文件（特別是 Include/internal/pycore_pystate.h）。 不透明的 PyInterpreterState 作為僅有 API（以及穩(wěn)定版 ABI）的一部分仍然可用。 文檔指明該結(jié)構(gòu)的任何字段都不是公有的，因此我們希望沒人在使用它們。 但是，如果你確實依賴其中某一個或更多個私有字段并且沒有其他替代選項，則請開一個 BPO 問題。 我們將盡力幫助你進行調(diào)整（可能包括向公有 API 添加訪問器函數(shù)）。 （參見 bpo-35886。）

• 現(xiàn)在所有平臺下的 mmap.flush() 方法都會在成功時返回 None 并在錯誤時引發(fā)異常。 之前它的行為取決于具體平臺： Windows 下會在成功時返回非零值；在失敗時返回零。 Unix 下會在成功時返回零；在失敗時引發(fā)錯誤。 （由 Berker Peksag 在 bpo-2122 中貢獻。）

• xml.dom.minidom 和 xml.sax 模塊默認將不再處理外部實體。 （由 Christian Heimes 在 bpo-17239 中貢獻。）

• 從只讀的 dbm 數(shù)據(jù)庫 (dbm.dumb, dbm.gnu 或 dbm.ndbm) 刪除鍵將會引發(fā) error (dbm.dumb.error, dbm.gnu.error 或 dbm.ndbm.error) 而不是 KeyError。 （由 Xiang Zhang 在 bpo-33106 中貢獻。）

• 簡化了字面值的 AST。 所有常量將被表示為 ast.Constant 的實例。 實例化舊類 Num, Str, Bytes, NameConstant 和 Ellipsis 都將返回 Constant 的實例。 （由 Serhiy Storchaka 在 bpo-32892 中貢獻。）

• expanduser() 在 Windows 上現(xiàn)在改用 USERPROFILE 環(huán)境變量而不再使用 HOME，后者通常不會為一般用戶賬戶設(shè)置。 （由 Anthony Sottile 在 bpo-36264 中貢獻。）

• 異常 asyncio.CancelledError 現(xiàn)在繼承自 BaseException 而不是 Exception 并且不再繼承自 concurrent.futures.CancelledError。 （由 Yury Selivanov 在 bpo-32528 中貢獻。）

• 當(dāng)使用 asyncio.Task 的實例時，函數(shù) asyncio.wait_for() 現(xiàn)在會正確地等待撤銷。 在此之前當(dāng)達到 timeout 時，它會被撤銷并立即返回。 （由 Elvis Pranskevichus 在 bpo-32751 中貢獻。）

• 當(dāng)將 'socket' 作為 name 形參傳入時，函數(shù) asyncio.BaseTransport.get_extra_info() 現(xiàn)在會返回一個可安全使用的套接字對象。 （由 Yury Selivanov 在 bpo-37027 中貢獻。）

• asyncio.BufferedProtocol 已經(jīng)晉級為穩(wěn)定 API。

• 在 Windows 上對擴展模塊的 DLL 依賴以及通過 ctypes 加載的 DLL 的解析現(xiàn)在將更為安全。 只有系統(tǒng)路徑、包含相信 DLL 或 PYD 文件的路徑以及通過 add_dll_directory() 添加的目錄才會被作為加載時依賴的搜索位置。 特別地，PATH 和當(dāng)前工作目錄將不再被使用，對它們的修改將不再對正常的 DLL 解析產(chǎn)生影響。 如果你的應(yīng)用依賴于這些機制，你應(yīng)當(dāng)先檢查 add_dll_directory()，如果它存在就用它在加載你的庫時添加你的 DLL 目錄。 請注意 Windows 7 用戶還需要確保 Windows 更新包 KB2533623 已安裝（這一點也會由安裝器進行驗證）。 （由 Steve Dower 在 bpo-36085 中貢獻。）

• 關(guān)聯(lián)到 pgen 的頭文件和函數(shù)在其被純 Python 實現(xiàn)取代后已被移除。 （由 Pablo Galindo 在 bpo-36623 中貢獻。）

• types.CodeType 在構(gòu)造器的第二個位置新增了一個形參 (posonlyargcount) 以支持在 PEP 570 中定義的僅限位置參數(shù)。 第一個參數(shù) (argcount) 現(xiàn)在表示位置參數(shù)的總數(shù)量 (包括僅限位置參數(shù))。 types.CodeType 中新增的 replace() 方法可用于讓代碼支持 future 特性。

C API 的變化?

• PyCompilerFlags 結(jié)構(gòu)體添加了一個新的 cf_feature_version 字段。 它應(yīng)當(dāng)被初始化為 PY_MINOR_VERSION。 該字段默認會被忽略，當(dāng)且僅當(dāng) PyCF_ONLY_AST 在 cf_flags 中設(shè)置旗標時才會被使用。 （由 Guido van Rossum 在 bpo-35766 中貢獻。）

• PyEval_ReInitThreads() 函數(shù)已從 C API 中移除。 它不應(yīng)當(dāng)被顯式地調(diào)用；請改用 PyOS_AfterFork_Child()。 （由 Victor Stinner 在 bpo-36728 中貢獻。）

• 在 Unix 上，C 擴展不會再被鏈接到 libpython，但 Android 和 Cygwin 例外。 當(dāng) Python 被嵌入時，libpython 不可使用 RTLD_LOCAL 加載，而要改用 RTLD_GLOBAL。 之前使用 RTLD_LOCAL 已經(jīng)不可能加載未鏈接到 libpython 的 C 擴展了，例如通過 Modules/Setup 的 *shared* 部分構(gòu)建的標準庫 C 擴展。 （由 Victor Stinner 在 bpo-21536 中貢獻。）

• 在解析或構(gòu)建值時（例如 PyArg_ParseTuple(), Py_BuildValue(), PyObject_CallFunction() 等等）使用形如 # 的格式而不定義 PY_SSIZE_T_CLEAN 現(xiàn)在將會引發(fā) DeprecationWarning。 它將在 3.10 或 4.0 中被移除。 請參閱 解析參數(shù)并構(gòu)建值變量 了解詳情。 （由 Inada Naoki 在 bpo-36381 中貢獻。）

• 堆分配類型的實例（例如使用 PyType_FromSpec() 創(chuàng)建的實例）會保存一個對其類型對象的引用。 提升這些類型對象引用計數(shù)的操作已從 PyType_GenericAlloc() 移至更低層級的函數(shù) PyObject_Init() 和 PyObject_INIT()。 這使用通過This makes types created through PyType_FromSpec() 所創(chuàng)建類型的行為與管理代碼中的其他類保持一致。

  靜態(tài)分配類型 將不受影響。

  在大部分情況下，這應(yīng)該都不會有附帶影響。 但是，在分配實例后手動提升引用計數(shù)的類型（也許是為了繞過漏洞）現(xiàn)在可能永遠不會被銷毀。 要避免這種情況，這些類需要在實例撤銷分配期間在類型對象上調(diào)用 Py_DECREF。

  要正確地將這些類型移植到 3.8，請應(yīng)用以下修改：

  • 在分配實例之后在類型對象上移除 Py_INCREF —— 如果有的話。 這可以發(fā)生在調(diào)用 PyObject_New(), PyObject_NewVar(), PyObject_GC_New(), PyObject_GC_NewVar() 或任何其他使用 PyObject_Init() 或 PyObject_INIT() 的自定義分配器之后。

    示例:

    static foo_struct *
    foo_new(PyObject *type) {
        foo_struct *foo = PyObject_GC_New(foo_struct, (PyTypeObject *) type);
        if (foo == NULL)
            return NULL;
    #if PY_VERSION_HEX < 0x03080000
        // Workaround for Python issue 35810; no longer necessary in Python 3.8
        PY_INCREF(type)
    #endif
        return foo;
    }
    

  • 確保所有堆分配類型的自定義 tp_dealloc 函數(shù)會減少類型的引用計數(shù)。

    示例:

    static void
    foo_dealloc(foo_struct *instance) {
        PyObject *type = Py_TYPE(instance);
        PyObject_GC_Del(instance);
    #if PY_VERSION_HEX >= 0x03080000
        // This was not needed before Python 3.8 (Python issue 35810)
        Py_DECREF(type);
    #endif
    }
    

  （由 Eddie Elizondo 在 bpo-35810 中貢獻。）

• Py_DEPRECATED() 宏已經(jīng)針對 MSVC 實現(xiàn)。 這個宏現(xiàn)在必須放在符號名稱之前。

  示例:

  Py_DEPRECATED(3.8) PyAPI_FUNC(int) Py_OldFunction(void);
  

  （由 Zackery Spytz 在 bpo-33407 中貢獻。）

• 解釋器將不再假裝支持跨發(fā)布版本的擴展類型二進制兼容性。 由第三方擴展模塊所導(dǎo)出的 PyTypeObject 應(yīng)該具有當(dāng)前 Python 版本所要求的所有空位，包括 tp_finalize (Py_TPFLAGS_HAVE_FINALIZE 不會再在讀取 tp_finalize 之前被檢查)。

  （由 Antoine Pitrou 在 bpo-32388 中貢獻。）

• 函數(shù) PyNode_AddChild() 和 PyParser_AddToken() 現(xiàn)在接受兩個額外的 int 參數(shù) end_lineno 和 end_col_offset。

• 允許 MinGW 工具直接鏈接到 python38.dll 的 libpython38.a 文件已不再包含于標準的 Windows 分發(fā)包中。 如果你需要此文件，可使用 gendef 和 dlltool 工具來生成它，這些工具是 MinGW binutils 包的一部分：

  gendef - python38.dll > tmp.def
  dlltool --dllname python38.dll --def tmp.def --output-lib libpython38.a
  

  已安裝的 pythonXY.dll 所在位置將取決于安裝選項以及 Windows 的版本和語言。 請參閱 在Windows上使用 Python 了解更多信息。 該結(jié)果庫應(yīng)當(dāng)放在與 pythonXY.lib 相同的目錄下，這通常是你的 Python 安裝路徑下的 libs 目錄。

  （由 Steve Dower 在 bpo-37351 中貢獻。）

CPython 字節(jié)碼的改變?

• 解釋器循環(huán)已通過將塊堆棧展開邏輯移入編譯器獲得了簡化。 編譯器現(xiàn)在會發(fā)出顯式指令來調(diào)整值堆棧并為 break, continue 和 return 調(diào)用清除代碼。

  移除了操作碼 BREAK_LOOP, CONTINUE_LOOP, SETUP_LOOP 和 SETUP_EXCEPT。 添加了新的操作碼 ROT_FOUR, BEGIN_FINALLY, CALL_FINALLY 和 POP_FINALLY。 修改了 END_FINALLY 和 WITH_CLEANUP_START 的行為。

  （由 Mark Shannon, Antoine Pitrou 和 Serhiy Storchaka 在 bpo-17611 中貢獻。）

• 添加了新的操作碼 END_ASYNC_FOR 用于處理當(dāng)?shù)却?async for 循環(huán)的下一項時引發(fā)的異常。 （由 Serhiy Storchaka 在 bpo-33041 中貢獻。）

• MAP_ADD 現(xiàn)在會預(yù)期值為棧的第一個元素而鍵為第二個元素。 作出此改變以使得字典推導(dǎo)式能如 PEP 572 所提議的那樣，鍵總是會在值之前被求值。 （由 J?rn Heissler 在 bpo-35224 中貢獻。）

演示和工具?

添加了一個檢測腳本用于對訪問變量的不同方式進行計時: Tools/scripts/var_access_benchmark.py。 （由 Raymond Hettinger 在 bpo-35884 中貢獻。）

以下是自 Python 3.3 以來性能提升情況的總結(jié):

Python version                       3.3     3.4     3.5     3.6     3.7     3.8
--------------                       ---     ---     ---     ---     ---     ---

Variable and attribute read access:
    read_local                       4.0     7.1     7.1     5.4     5.1     3.9
    read_nonlocal                    5.3     7.1     8.1     5.8     5.4     4.4
    read_global                     13.3    15.5    19.0    14.3    13.6     7.6
    read_builtin                    20.0    21.1    21.6    18.5    19.0     7.5
    read_classvar_from_class        20.5    25.6    26.5    20.7    19.5    18.4
    read_classvar_from_instance     18.5    22.8    23.5    18.8    17.1    16.4
    read_instancevar                26.8    32.4    33.1    28.0    26.3    25.4
    read_instancevar_slots          23.7    27.8    31.3    20.8    20.8    20.2
    read_namedtuple                 68.5    73.8    57.5    45.0    46.8    18.4
    read_boundmethod                29.8    37.6    37.9    29.6    26.9    27.7

Variable and attribute write access:
    write_local                      4.6     8.7     9.3     5.5     5.3     4.3
    write_nonlocal                   7.3    10.5    11.1     5.6     5.5     4.7
    write_global                    15.9    19.7    21.2    18.0    18.0    15.8
    write_classvar                  81.9    92.9    96.0   104.6   102.1    39.2
    write_instancevar               36.4    44.6    45.8    40.0    38.9    35.5
    write_instancevar_slots         28.7    35.6    36.1    27.3    26.6    25.7

Data structure read access:
    read_list                       19.2    24.2    24.5    20.8    20.8    19.0
    read_deque                      19.9    24.7    25.5    20.2    20.6    19.8
    read_dict                       19.7    24.3    25.7    22.3    23.0    21.0
    read_strdict                    17.9    22.6    24.3    19.5    21.2    18.9

Data structure write access:
    write_list                      21.2    27.1    28.5    22.5    21.6    20.0
    write_deque                     23.8    28.7    30.1    22.7    21.8    23.5
    write_dict                      25.9    31.4    33.3    29.3    29.2    24.7
    write_strdict                   22.9    28.4    29.9    27.5    25.2    23.1

Stack (or queue) operations:
    list_append_pop                144.2    93.4   112.7    75.4    74.2    50.8
    deque_append_pop                30.4    43.5    57.0    49.4    49.2    42.5
    deque_append_popleft            30.8    43.7    57.3    49.7    49.7    42.8

Timing loop:
    loop_overhead                    0.3     0.5     0.6     0.4     0.3     0.3

基準測試是在 Intel? Core? i7-4960HQ 處理器 上運行從 python.org 獲取的 macOS 64 位版得到的數(shù)據(jù)。 基準測試腳本顯示時間以納秒為單位。