字典合并與更新運算符?

合并 (|) 與更新 (|=) 運算符已被加入內置的 dict 類(lèi)。 它們?yōu)楝F有的 dict.update 和 {**d1, **d2} 字典合并方法提供了補充。

示例:

>>> x = {"key1": "value1 from x", "key2": "value2 from x"}
>>> y = {"key2": "value2 from y", "key3": "value3 from y"}
>>> x | y
{'key1': 'value1 from x', 'key2': 'value2 from y', 'key3': 'value3 from y'}
>>> y | x
{'key2': 'value2 from x', 'key3': 'value3 from y', 'key1': 'value1 from x'}

詳見(jiàn) PEP 584。（Brandt Bucher 在 bpo-36144 中的貢獻。）

新增用于移除前綴和后綴的字符串方法?

增加了 str.removeprefix(prefix) 和 str.removesuffix(suffix) 用于方便地從字符串移除不需要的前綴或后綴。 也增加了 bytes, bytearray 以及 collections.UserString 的對應方法。 請參閱 PEP 616 了解詳情。 （由 Dennis Sweeney 在 bpo-39939 中貢獻。）

標準多項集中的類(lèi)型標注泛型?

在類(lèi)型標注中現在你可以使用內置多項集類(lèi)型例如 list 和 dict 作為通用類(lèi)型而不必從 typing 導入對應的大寫(xiě)形式類(lèi)型名 (例如 List 和 Dict)。 標準庫中的其他一些類(lèi)型現在同樣也是通用的，例如 queue.Queue。

示例:

def greet_all(names: list[str]) -> None:
    for name in names:
        print("Hello", name)

詳見(jiàn) PEP 585。（由 Guido van Rossum、Ethan Smith 和 Batuhan Ta?kaya 在 bpo-39481 中貢獻。）

新的解析器?

Python 3.9 使用于基于 PEG 的新解析器替代 LL(1)。 新解析器的性能與舊解析器大致相當，但 PEG 在設計新語(yǔ)言特性時(shí)的形式化比 LL(1) 更靈活。 我們將在 Python 3.10 及之后版本中開(kāi)始使用這種靈活性。

ast 模塊會(huì )使用新解析器并會(huì )生成與舊解析器一致的 AST。

在 Python 3.10 中，舊解析器將被移除，依賴(lài)于它的所有功能也將被移除（主要是 parser 模塊，它早已被棄用）。 只有 在 Python 3.9 中，你可以使用命令行開(kāi)關(guān) (-X oldparser) 或環(huán)境變量 (PYTHONOLDPARSER=1) 切換回 LL(1) 解析器。

請參閱 PEP 617 了解詳情。 （由 Guido van Rossum, Pablo Galindo 和 Lysandros Nikolaou 在 bpo-40334 中貢獻。）

zoneinfo?

zoneinfo 模塊為標準庫引入了 IANA 時(shí)區數據庫。 它添加了 zoneinfo.ZoneInfo，這是一個(gè)基于系統時(shí)區數據的實(shí)體 datetime.tzinfo 實(shí)現。

示例:

>>> from zoneinfo import ZoneInfo
>>> from datetime import datetime, timedelta

>>> # Daylight saving time
>>> dt = datetime(2020, 10, 31, 12, tzinfo=ZoneInfo("America/Los_Angeles"))
>>> print(dt)
2020-10-31 12:00:00-07:00
>>> dt.tzname()
'PDT'

>>> # Standard time
>>> dt += timedelta(days=7)
>>> print(dt)
2020-11-07 12:00:00-08:00
>>> print(dt.tzname())
PST

作為不包含 IANA 數據庫的平臺的一個(gè)回退數據源，還以第一方軟件包的形式發(fā)布了 tzdata 模塊 -- 通過(guò) PyPI 發(fā)行并由 CPython 核心團隊維護。

graphlib?

添加了新的 graphlib 模塊，其中包含 graphlib.TopologicalSorter 類(lèi)來(lái)提供圖的拓撲排序功能。 （由 Pablo Galindo, Tim Peters 和 Larry Hastings 在 bpo-17005 中貢獻。）

ast?

將 indent 選項添加到 dump()，這允許它產(chǎn)生多行縮進(jìn)的輸出。 （由 Serhiy Storchaka 在 bpo-37995 中貢獻。）

添加了 ast.unparse() 作為 ast 模塊中的一個(gè)函數，它可被用來(lái)反解析 ast.AST 對象并產(chǎn)生相應的代碼字符串，當它被解析時(shí)將會(huì )產(chǎn)生一個(gè)等價(jià)的 ast.AST 對象。 （由 Pablo Galindo 和 Batuhan Taskaya 在 bpo-38870 中貢獻。）

為 AST 節點(diǎn)添加了文檔字符串，其中包含 ASDL 簽名，可被用來(lái)構造對應的節點(diǎn)。 （由 Batuhan Taskaya 在 bpo-39638 中貢獻。）

asyncio?

出于重要的安全性考量，asyncio.loop.create_datagram_endpoint() 的 reuse_address 形參不再被支持。 這是由 UDP 中的套接字選項 SO_REUSEADDR 的行為導致的。 更多細節請參閱 loop.create_datagram_endpoint() 的文檔。 （由 Kyle Stanley, Antoine Pitrou 和 Yury Selivanov 在 bpo-37228 中貢獻。。）

添加了新的 coroutine shutdown_default_executor()，它可為等待 ThreadPoolExecutor 結束關(guān)閉的默認執行器安排關(guān)閉日程操作。 此外，asyncio.run() 已被更新以使用新的 coroutine。 （由 Kyle Stanley 在 bpo-34037 中貢獻。）

添加了 asyncio.PidfdChildWatcher，這是一個(gè) Linux 專(zhuān)屬的子監視器實(shí)現，它負責輪詢(xún)進(jìn)程的文件描述符。 (bpo-38692)

添加了新的 coroutine asyncio.to_thread()。 它主要被用于在單獨線(xiàn)程中運行 IO 密集型函數以避免阻塞事件循環(huán)，實(shí)質(zhì)上就相當于是 run_in_executor() 的高層級版本，可直接接受關(guān)鍵字參數。 （由 Kyle Stanley 和 Yury Selivanov 在 bpo-32309 中貢獻。）

當由于超時(shí)而取消任務(wù)時(shí)，asyncio.wait_for() 現在將會(huì )等待直到也在 timeout 值 <= 0 的情況下完成取消。 就像 timeout 值為正數時(shí)一樣。 （由 Elvis Pranskevichus 在 bpo-32751 中貢獻。）

當附帶 ssl.SSLSocket 套接字調用不兼容的方法時(shí) asyncio 現在會(huì )引發(fā) TyperError。 （由 Ido Michael 在 bpo-37404 中貢獻。）

compileall?

為重復的 .pyc 文件添加了使用硬軟件的可能性: hardlink_dupes 形參以及 --hardlink-dupes 命令行選項。 （由 Lumír 'Frenzy' Balhar 在 bpo-40495 中貢獻。）

新增了一些用于在結果 .pyc 文件中操縱路徑的選項: stripdir, prependdir, limit_sl_dest 形參以及 -s, -p, -e 命令行選項。 并使得為優(yōu)化等級多次指定選項成為可能。 （由 Lumír 'Frenzy' Balhar 在 bpo-38112 中貢獻。）

concurrent.futures?

將新的 cancel_futures 形參添加到 concurrent.futures.Executor.shutdown()，可以取消尚未開(kāi)始運行的所有掛起的 Future，而不必等待它們完成運行再關(guān)閉執行器。 （由 Kyle Stanley 在 bpo-39349 中貢獻。）

從 ThreadPoolExecutor 和 ProcessPoolExecutor 中移除了守護線(xiàn)程。 這改善與與子解釋器的兼容性及它們在關(guān)閉進(jìn)程時(shí)的可預測性。 （由 Kyle Stanley 在 bpo-39812 中貢獻。）

現在 ProcessPoolExecutor 中的工作進(jìn)程僅會(huì )在沒(méi)有可重用的空閑工作進(jìn)程時(shí)按需產(chǎn)生。 這優(yōu)化了啟動(dòng)開(kāi)銷(xiāo)并減少了由空閑工作進(jìn)程導致的 CPU 時(shí)間損失。 （由 Kyle Stanley 在 bpo-39207 中貢獻。）

curses?

增加了 curses.get_escdelay(), curses.set_escdelay(), curses.get_tabsize() 以及 curses.set_tabsize() 函數。（由 Anthony Sottile 在 bpo-38312 中貢獻。）

datetime?

datetime.date 的 isocalendar() 以及 datetime.datetime 的 isocalendar() 等方法現在將返回 namedtuple() 而不是 tuple。 （由 Dong-hee Na 在 bpo-24416 中貢獻。）

distutils?

upload 命令現在會(huì )創(chuàng )建 SHA2-256 和 Blake2b-256 哈希摘要。 它會(huì )在禁用 MD5 摘要的平臺上跳過(guò) MD5。 （由 Christian Heimes 在 bpo-40698 中貢獻。）

fcntl?

增加了 F_OFD_GETLK, F_OFD_SETLK 和 F_OFD_SETLKW 等常量。 （由 Dong-hee Na 在 bpo-38602 中貢獻。）

ftplib?

現在 FTP 和 FTP_TLS 當它們的構造器所給定的超時(shí)參數為零以防止創(chuàng )建非阻塞套接字時(shí)會(huì )引發(fā) ValueError。 （由 Dong-hee Na 在 bpo-39259 中貢獻。）

gc?

當垃圾回收器進(jìn)行某些復活對象的收集時(shí)（在終結器被執行之后這些對象可以在隔離周期之外被訪(fǎng)問(wèn)），不會(huì )阻止對所有仍然無(wú)法訪(fǎng)問(wèn)的對象的收集。 （由 Pablo Galindo 和 Tim Peters 在 bpo-38379 中貢獻。）

增加了一個(gè)新的函數 gc.is_finalized() 用來(lái)檢測一個(gè)對象是否已被垃圾回收器所終結。 （由 Pablo Galindo 在 bpo-39322 中貢獻。）

hashlib?

hashlib 模塊現在會(huì )在可能的情況下使用 OpenSSL 中的 SHA3 哈希和 SHAKE XOF。 （由 Christian Heimes 在 bpo-37630 中貢獻。）

內置的哈希模塊現在可通過(guò) ./configure --without-builtin-hashlib-hashes 禁用或通過(guò) ./configure --with-builtin-hashlib-hashes=sha3,blake2 這樣的形式有選擇地啟用以強制使用基于 OpenSSL 的實(shí)現。 （由 Christian Heimes 在 bpo-40479 中貢獻）

http?

添加 HTTP 狀態(tài)碼 103 EARLY_HINTS, 418 IM_A_TEAPOT 和 425 TOO_EARLY 到 http.HTTPStatus。 （由 Dong-hee Na 在 bpo-39509 以及 Ross Rhodes 在 bpo-39507 中貢獻。）

IDLE 與 idlelib?

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

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

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

New in 3.9 maintenance releases

Make IDLE invoke sys.excepthook() (when started without '-n'). User hooks were previously ignored. (Contributed by Ken Hilton in bpo-43008.)

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

Rearrange the settings dialog. Split the General tab into Windows and Shell/Ed tabs. Move help sources, which extend the Help menu, to the Extensions tab. Make space for new options and shorten the dialog. The latter makes the dialog better fit small screens. (Contributed by Terry Jan Reedy in bpo-40468.) Move the indent space setting from the Font tab to the new Windows tab. (Contributed by Mark Roseman and Terry Jan Reedy in bpo-33962.)

Apply syntax highlighting to .pyi files. (Contributed by Alex Waygood and Terry Jan Reedy in bpo-45447.)

imaplib?

現在 IMAP4 和 IMAP4_SSL 的構造器具有可選的 timeout 形參。 并且，現在 open() 方法也具有可選的 timeout 形參提供同樣的修改。 IMAP4_SSL 和 IMAP4_stream 中被重載的方法也應用了這個(gè)修改。 （由 Dong-hee Na 在 bpo-38615 中貢獻。）

增加了 imaplib.IMAP4.unselect()。 imaplib.IMAP4.unselect() 會(huì )釋放關(guān)聯(lián)到選定郵箱的服務(wù)器資源并將服務(wù)器返回到已認證狀態(tài)。 此命令會(huì )執行與 imaplib.IMAP4.close() 相同的動(dòng)作，區別在于它不會(huì )從當前選定郵箱中永久性地移除消息。 （由 Dong-hee Na 在 bpo-40375 中貢獻。）

importlib?

為提升與 import 語(yǔ)句的一致性，現在 importlib.util.resolve_name() 對于無(wú)效的相對導入嘗試會(huì )引發(fā) ImportError 而不是 ValueError。 （由 Ngalim Siregar 在 bpo-37444 中貢獻。）

發(fā)布不可變模塊對象的導入加載器除了發(fā)布單獨模塊以外現在也可以發(fā)布不可變包。 （由 Dino Viehland 在 bpo-39336 中貢獻。）

添加了帶有對包數據中子目錄支持的 importlib.resources.files() 函數，與 importlib_resources 1.5 版的反向端口相匹配。（由 Jason R. Coombs 在 bpo-39791 中貢獻。）

來(lái)自 importlib_metadata 1.6.1 版的已更新 importlib.metadata。

inspect?

inspect.BoundArguments.arguments 已從 OrderedDict 改為常規字典。 （由 Inada Naoki 在 bpo-36350 和 bpo-39775 中貢獻。）

ipaddress?

ipaddress 現在支持 IPv6 作用域地址（即帶有 %<scope_id> 前綴的 IPv6 地址）。

IPv6 作用域地址可使用 ipaddress.IPv6Address 來(lái)解析。 作用域的區 ID 如果存在，可通過(guò) scope_id 屬性來(lái)獲取。 （由 Oleksandr Pavliuk 在 bpo-34788 中貢獻。）

從 Python 3.9.5 開(kāi)始 ipaddress 模塊不再接受 IPv4 地址字符串中有任何前綴的零。 （由 Christian Heimes 在 bpo-36384 中貢獻。）

math?

對 math.gcd() 函數進(jìn)行了擴展以處理多個(gè)參數。 在之前版本中，它只支持兩個(gè)參數。 （由 Serhiy Storchaka 在 bpo-39648 中貢獻。）

增加了 math.lcm(): 返回指定參數的最小公倍數。 （由 Mark Dickinson, Ananthakrishnan 和 Serhiy Storchaka 在 bpo-39479 和 bpo-39648 中貢獻。）

增加了 math.nextafter(): 返回從 x 往 y 方向的下一個(gè)浮點(diǎn)數值。 （由 Victor Stinner 在 bpo-39288 中貢獻。）

增加了 math.ulp(): 返回一個(gè)浮點(diǎn)數的最小有效比特位。 （由 Victor Stinner 在 bpo-39310 中貢獻。）

multiprocessing?

multiprocessing.SimpleQueue 類(lèi)新增了 close() 方法用來(lái)顯式地關(guān)閉隊列。 （由 Victor Stinner 在 bpo-30966 中貢獻。）

nntplib?

現在 NNTP 和 NNTP_SSL 當它們的構造器所給定的超時(shí)參數為零以防止創(chuàng )建非阻塞套接字時(shí)會(huì )引發(fā) ValueError。 （由 Dong-hee Na 在 bpo-39259 中貢獻。）

os?

增加了 CLD_KILLED 和 CLD_STOPPED 作為 si_code。 （由 Dong-hee Na 在 bpo-38493 中貢獻。）

對外公開(kāi)了 Linux 專(zhuān)屬的 os.pidfd_open() (bpo-38692) 和 os.P_PIDFD (bpo-38713) 用于文件描述符的進(jìn)程管理。

現在 os.unsetenv() 函數在 Windows 上也已可用。 （由 Victor Stinner 在 bpo-39413 中貢獻。）

現在 os.putenv() 和 os.unsetenv() 函數將總是可用。 （由 Victor Stinner 在 bpo-39395 中貢獻。）

增加了 os.waitstatus_to_exitcode() 函數：將等待狀態(tài)轉換為退出碼。 （由 Victor Stinner 在 bpo-40094 中貢獻。）

pathlib?

增加了 pathlib.Path.readlink()，其行為類(lèi)似于 os.readlink()。 （由 Girts Folkmanis 在 bpo-30618 中貢獻。）

pdb?

在 Windows 上 Pdb 現在支持 ~/.pdbrc。 （由 Tim Hopper 和 Dan Lidral-Porter 在 bpo-20523 中貢獻。）

poplib?

現在 POP3 和 POP3_SSL 當它們的構造器所給定的超時(shí)參數為零以防止創(chuàng )建非阻塞套接字時(shí)會(huì )引發(fā) ValueError。 （由 Dong-hee Na 在 bpo-39259 中貢獻。）

pprint?

現在 pprint 能美化打印 types.SimpleNamespace。 （由 Carl Bordum Hansen 在 bpo-37376 中貢獻。）

pydoc?

文檔字符串的顯示現在不僅針對類(lèi)、函數、方法等，也針對任何具有自己的 __doc__ 屬性的對象。 （由 Serhiy Storchaka 在 bpo-40257 中貢獻。）

random?

增加了新的 random.Random.randbytes 方法：生成隨機字節串。 （由 Victor Stinner 在 bpo-40286 中貢獻。）

signal?

對外公開(kāi)了 Linux 專(zhuān)屬的 signal.pidfd_send_signal() 用于向使用文件描述符而非 pid 的進(jìn)程發(fā)送信號。 (bpo-38712)

smtplib?

現在 SMTP 和 SMTP_SSL 當它們的構造器所給定的超時(shí)參數為零以防止創(chuàng )建非阻塞套接字時(shí)會(huì )引發(fā) ValueError。 （由 Dong-hee Na 在 bpo-39259 中貢獻。）

現在 LMTP 構造器具有可選的 timeout 形參。 （由 Dong-hee Na 在 bpo-39329 中貢獻。）

socket?

socket 模塊現在會(huì )在 Linux 4.1 或更高版本上導出 CAN_RAW_JOIN_FILTERS 常量。 （由 Stefan Tatschner 和 Zackery Spytz 在 bpo-25780 中貢獻。）

現在 socket 模塊會(huì )在支持的平臺上支持 CAN_J1939 協(xié)議。 （由 Karl Ding 在 bpo-40291 上貢獻。）

現在 socket 模塊具有 socket.send_fds() 和 socket.recv_fds() 函數。 （由 Joannah Nanjekye, Shinya Okano 和 Victor Stinner 在 bpo-28724 中貢獻。）

time?

On AIX, thread_time() is now implemented with thread_cputime() which has nanosecond resolution, rather than clock_gettime(CLOCK_THREAD_CPUTIME_ID) which has a resolution of 10 milliseconds. (Contributed by Batuhan Taskaya in bpo-40192)

sys?

增加了新的 sys.platlibdir 屬性：平臺專(zhuān)屬庫目錄的名稱(chēng)。 它被用于構建標準庫的路徑以及已安裝擴展模塊的路徑。 它在大多數平臺上等于 "lib"。 在 Fedora 和 SuSE 上，它等于 64 位平臺上的 "lib64"。 （由 Jan Matějek, Matěj Cepl, Charalampos Stratakis 和 Victor Stinner 在 bpo-1294959 中貢獻。）

之前的版本中，sys.stderr 在非交互模式時(shí)是帶塊緩沖的。 現在 stderr 默認總是為行緩沖的。 （由 Jendrik Seipp 在 bpo-13601 中貢獻。）

tracemalloc?

增加了 tracemalloc.reset_peak() 用于將跟蹤的內存塊峰值大小設為當前大小，以測量特定代碼段的峰值。 （由 Huon Wilson 在 bpo-40630 中貢獻。）

typing?

PEP 593 引入了一種 typing.Annotated 類(lèi)型以使用上下文專(zhuān)屬的元數據來(lái)裝飾現有類(lèi)型，并將新的 include_extras 形參添加到 typing.get_type_hints() 以在運行時(shí)訪(fǎng)問(wèn)元數據。 （由 Till Varoquaux 和 Konstantin Kashin 貢獻。）

unicodedata?

Unicode 數據庫已更新到 13.0.0 版。 (bpo-39926)。

venv?

由 venv 所提供的激活腳本現在總是會(huì )使用 __VENV_PROMPT__ 設置的值來(lái)一致地指明它們的自定義提示符。 在之前版本中某些腳本會(huì )無(wú)條件地使用 __VENV_PROMPT__，而另一些腳本只在其恰好被設置時(shí)（這是默認情況）才會(huì )使用，還有的腳本會(huì )改用 __VENV_NAME__。 （由 Brett Cannon 在 bpo-37663 中貢獻。）

xml?

當把 xml.etree.ElementTree 序列化為 XML 文件時(shí)屬性?xún)炔康目瞻鬃址F在將被保留。 不同的行結束符不會(huì )再被正規化為 "n"。 這是對于如何解讀 XML 規范 2.11 節的相關(guān)討論的最終結果。 （由 Mefistotelis 在 bpo-39011 中貢獻。）

Python API 的變化?

• __import__() 和 importlib.util.resolve_name() 現在會(huì )引發(fā) ImportError 取代之前所引發(fā)的 ValueError。 捕獲特定異常類(lèi)型并同時(shí)支持 Python 3.9 和更早版本的調用者將需要使用 except (ImportError, ValueError): 來(lái)同時(shí)捕獲兩者。

• venv 激活腳本不再將 __VENV_PROMPT__ 被設為 "" 的情況作為特例處理。

• select.epoll.unregister() 方法不會(huì )再忽略 EBADF 錯誤。 （由 Victor Stinner 在 bpo-39239 中貢獻。）

• bz2.BZ2File 的 compresslevel 形參已成為僅限關(guān)鍵字形參，因為 buffering 形參已被移除。 （由 Victor Stinner 在 bpo-39357 中貢獻。）

• 簡(jiǎn)化了 AST 的抽取操作。 簡(jiǎn)單索引將以它們的值來(lái)代表，擴展切片將以元組形式來(lái)代表。 Index(value) 將返回 value 本身，ExtSlice(slices) 將返回 Tuple(slices, Load())。 （由 Serhiy Storchaka 在 bpo-34822 中貢獻。）

• 當使用了 -E 或 -I 命令行參數時(shí) importlib 模塊現在會(huì )忽略 PYTHONCASEOK 環(huán)境變量。

• encoding 形參已作為僅限關(guān)鍵字形參被添加到 ftplib.FTP 和 ftplib.FTP_TLS 類(lèi)，并且默認編碼格式由 Latin-1 改為 UTF-8 以遵循 RFC 2640。

• asyncio.loop.shutdown_default_executor() 已被添加到 AbstractEventLoop，這意味著(zhù)繼承自它的替代事件循環(huán)應當定義此方法。 （由 Kyle Stanley 在 bpo-34037 中貢獻。）

• 更新了 __future__ 模塊中未來(lái)特性旗標的常量值以防止與編譯器旗標相沖突。 在之前版本中 PyCF_ALLOW_TOP_LEVEL_AWAIT 會(huì )與 CO_FUTURE_DIVISION 發(fā)生沖突。 （由 Batuhan Taskaya 在 bpo-39562 中貢獻。）

• array('u') 現在使用 wchar_t 作為 C 類(lèi)型而不是 Py_UNICODE。 這個(gè)改變不會(huì )影響其行為，因為自 Python 3.3 起 Py_UNICODE 是 wchar_t 的別名。 （由 Inada Naoki 在 bpo-34538 中貢獻。）

• 現在 logging.getLogger() API 當傳入名稱(chēng) 'root' 時(shí)將返回根日志記錄器，而在之前它則返回一個(gè)名為 'root' 的非根日志記錄器。 這可能會(huì )影響到用戶(hù)代碼明確希望使用一個(gè)名為 'root' 的非根日志記錄器，或在某個(gè)名為 'root.py' 的最高層級模塊中使用 logging.getLogger(__name__) 來(lái)實(shí)例化日志記錄器的情況。 （由 Vinay Sajip 在 bpo-37742 中貢獻。）

• 現在 PurePath 的拆分處理當傳入 str 或 PurePath 的實(shí)例以外的對象時(shí)會(huì )返回 NotImplemented 而不是引發(fā) TypeError。 這將允許創(chuàng )建不繼承自上述類(lèi)型的兼容類(lèi)。 （由 Roger Aiudi 在 bpo-34775 中貢獻。）

• 從 Python 3.9.5 開(kāi)始 ipaddress 模塊不再接受 IPv4 地址字符串中有任何前綴的零。 前綴的零有歧義且會(huì )被某些庫解讀為八進(jìn)制數字。 例如舊版函數 socket.inet_aton() 就瘵前綴的零視為八進(jìn)制數字。 最新 inet_pton() 的 glibc 實(shí)現則不接受任何前綴的零。 （由 Christian Heimes 在 bpo-36384 中貢獻）。

• codecs.lookup() 現在會(huì )以與 encodings.normalize_encoding() 相同的方式正規化編碼格式名稱(chēng)，不同之處在于 codecs.lookup() 還會(huì )將名稱(chēng)轉換為小寫(xiě)形式。 例如``"latex+latin1"`` 編寫(xiě)格式名稱(chēng)現在會(huì )被正規化為 "latex_latin1"。 （由 Jordon Xu 在 bpo-37751 中貢獻。）

C API 的變化?

• Instances of 堆分配類(lèi)型 的實(shí)例（例如使用 PyType_FromSpec() 和類(lèi)似 API 創(chuàng )建的實(shí)例）自 Python 3.8 起會(huì )帶有一個(gè)對其類(lèi)型對象的引用。 正如 Python 3.8 的 "C API 的變化" 部分所述，對于大多數情況來(lái)說(shuō)，這應當不會(huì )有任何副作用，但對于具有自定義 tp_traverse 函數的類(lèi)型來(lái)說(shuō)，則要確保所有堆分配類(lèi)型的自定義 tp_traverse 函數可訪(fǎng)問(wèn)對象的類(lèi)型。

  示例:

  int
  foo_traverse(foo_struct *self, visitproc visit, void *arg) {
  // Rest of the traverse function
  #if PY_VERSION_HEX >= 0x03090000
      // This was not needed before Python 3.9 (Python issue 35810 and 40217)
      Py_VISIT(Py_TYPE(self));
  #endif
  }
  

  如果你的遍歷函數委托給了其基類(lèi)（或其他類(lèi)）的 tp_traverse，則要確保 Py_TYPE(self) 只被訪(fǎng)問(wèn)一次。 請注意應當只有 堆類(lèi)型 可訪(fǎng)問(wèn) tp_traverse 中的類(lèi)型。

  舉例來(lái)說(shuō)，如果你的 tp_traverse 函數包括以下內容:

  base->tp_traverse(self, visit, arg)
  

  則要添加:

  #if PY_VERSION_HEX >= 0x03090000
      // This was not needed before Python 3.9 (bpo-35810 and bpo-40217)
      if (base->tp_flags & Py_TPFLAGS_HEAPTYPE) {
          // a heap type's tp_traverse already visited Py_TYPE(self)
      } else {
          Py_VISIT(Py_TYPE(self));
      }
  #else
  

  （參閱 bpo-35810 和 bpo-40217 了解更多信息。）

• PyEval_CallObject, PyEval_CallFunction, PyEval_CallMethod 和 PyEval_CallObjectWithKeywords 函數已被棄用。 請改用 PyObject_Call() 及其變化形式。 （詳情參見(jiàn) bpo-29548。）

CPython 字節碼的改變?

• 添加了 LOAD_ASSERTION_ERROR 操作碼用于處理 assert 語(yǔ)句。 在之前的版本中，如果 AssertionError 異常被屏蔽則 assert 語(yǔ)句將不能正常運作。 （由 Zackery Spytz 在 bpo-34880 中貢獻。）

• COMPARE_OP 操作碼已被拆分為四個(gè)單獨指令:

  • COMPARE_OP 用于富比較

  • IS_OP 用于 'is' 和 'is not' 檢測

  • CONTAINS_OP 用于 'in' 和 'not in' 檢測

  • JUMP_IF_NOT_EXC_MATCH 用于檢查 'try-except' 語(yǔ)句中的異常。

  （由 Mark Shannon 在 bpo-39156 中貢獻。）

新的特性?

• PEP 573: 添加了 PyType_FromModuleAndSpec() 用于通過(guò)類(lèi)來(lái)關(guān)聯(lián)一個(gè)模塊；PyType_GetModule() 和 PyType_GetModuleState() 用于獲取模塊及其狀態(tài)；以及 PyCMethod 和 METH_METHOD 用于允許一個(gè)方法訪(fǎng)問(wèn)其定義所在的類(lèi)。 （由 Marcel Plch 和 Petr Viktorin 在 bpo-38787 中貢獻。）

• 增加了 PyFrame_GetCode() 函數：獲取幀代碼。 增加了 PyFrame_GetBack() 函數：獲取幀的下一個(gè)外部幀。 （由 Victor Stinner 在 bpo-40421 中貢獻。）

• 將 PyFrame_GetLineNumber() 添加到受限的 C API。 （由 Victor Stinner 在 bpo-40421 中貢獻。）

• 增加了 PyThreadState_GetInterpreter() 和 PyInterpreterState_Get() 函數用于獲取解釋器。 增加了 PyThreadState_GetFrame() 函數用于獲取 Python 線(xiàn)程狀態(tài)的當前幀。 增加了 PyThreadState_GetID() 函數：獲取 Python 線(xiàn)程狀態(tài)的唯一標識符。 （由 Victor Stinner 在 bpo-39947 中貢獻。）

• 將新的公有 PyObject_CallNoArgs() 函數添加到 C API，該函數可不帶任何參數調用一個(gè) Python 可調用對象。 它是不帶參數調用 Python 可調用對象最有效率的方式。 （由 Victor Stinner 在 bpo-37194 中貢獻。）

• 受限 C API 中的改變（如果定義了 Py_LIMITED_API 宏）:

  • 提供 Py_EnterRecursiveCall() 和 Py_LeaveRecursiveCall() 作為常規函數用于受限 API。 在之前版本中是使用宏定義，但這些宏不能與無(wú)法訪(fǎng)問(wèn) PyThreadState.recursion_depth 字段的受限 C API 一同編譯（該結構體在受限 C API 中是不透明的）。

  • PyObject_INIT() 和 PyObject_INIT_VAR() 已成為常規“不透明”函數以隱藏實(shí)現細節。

  （由 Victor Stinner 在 bpo-38644 和 bpo-39542 中貢獻。）

• 增加了 PyModule_AddType() 函數以協(xié)助將類(lèi)型加入到模塊中。 （由 Dong-hee Na 在 bpo-40024 中貢獻。）

• 將 PyObject_GC_IsTracked() 和 PyObject_GC_IsFinalized() 函數添加到公有 API 以允許分別查詢(xún) Python 對象當前是正在被追蹤還是已經(jīng)被垃圾回收器所終結。 （由 Pablo Galindo Salgado 在 bpo-40241 中貢獻。）

• 增加了 _PyObject_FunctionStr() 以獲取函數類(lèi)對象的用戶(hù)友好的表示形式。 （由 Jeroen Demeyer 在 bpo-37645 中修正。）

• 增加了 PyObject_CallOneArg() 用于調用具有一個(gè)位置參數的對象（由 Jeroen Demeyer 在 bpo-37483 中修正。）

移植到 Python 3.9?

• PyInterpreterState.eval_frame (PEP 523) 現在需要有新的強制性形參 tstate (PyThreadState*)。 （由 Victor Stinner 在 bpo-38500 中貢獻。）

• 擴展模塊: PyModuleDef 的 m_traverse, m_clear 和 m_free 等函數在模塊狀態(tài)被請求但尚未被分配時(shí)將不會(huì )再被調用。 這種情況出現在模塊被創(chuàng )建之后且模塊被執行 (Py_mod_exec 函數) 之前的時(shí)刻。 更準確地說(shuō)，這些函數在 m_size 大于 0 并且模塊狀態(tài)（即 PyModule_GetState() 的返回值）為 NULL 時(shí)將不會(huì )被調用。

  沒(méi)有模塊狀態(tài)的擴展模塊 (m_size <= 0) 不會(huì )受到影響。

• 現在如果 Py_AddPendingCall() 是在子解釋器內部被調用，該函數會(huì )被排入子解釋器的調用日程，而不是由主解釋器調用。 每個(gè)子解釋器現在都擁有它們自己的調用日程列表。 （由 Victor Stinner 在 bpo-39984 中貢獻。）

• 當 -E 選項被使用 (如果 PyConfig.use_environment 設為 0) 時(shí)將不再使用 Windows 注冊表來(lái)初始化 sys.path。 這會(huì )影響在 Windows 上嵌入 Python 的操作。 （由 Zackery Spytz 在 bpo-8901 中貢獻。）

• 全局變量 PyStructSequence_UnnamedField 現在為常量并且指向一個(gè)字符串常量。 （由 Serhiy Storchaka 在 bpo-38650 中貢獻。）

• 現在 PyGC_Head 結構是不透明的。 它只在內部 C API (pycore_gc.h) 中定義。 （由 Victor Stinner 在 bpo-40241 中貢獻。）

• Py_UNICODE_COPY, Py_UNICODE_FILL, PyUnicode_WSTR_LENGTH, PyUnicode_FromUnicode(), PyUnicode_AsUnicode(), _PyUnicode_AsUnicode 以及 PyUnicode_AsUnicodeAndSize() 在 C 中被標記為已棄用。 它們自 Python 3.3 起就已被 PEP 393 棄用。 （由 Inada Naoki 在 bpo-36346 中貢獻。）

• Py_FatalError() 函數會(huì )被一個(gè)自動(dòng)記錄當前函數名稱(chēng)的宏所替代，除非已定義了 Py_LIMITED_API 宏。 （由 Victor Stinner 在 bpo-39882 中貢獻。）

• vectorcall 協(xié)議現在要求調用者只傳入字符串作為鍵名。 （請參閱 bpo-37540 了解詳情。）

• 多個(gè)宏和函數的實(shí)現細節現在已被隱藏:

  • PyObject_IS_GC() 宏已被轉換為函數。

  • PyObject_NEW() 宏已成為 PyObject_New() 宏的別名，而 PyObject_NEW_VAR() 宏已成為 PyObject_NewVar() 宏的別名。 它們將不再直接訪(fǎng)問(wèn) PyTypeObject.tp_basicsize 成員。

  • PyObject_GET_WEAKREFS_LISTPTR() 宏已被轉換為函數：該宏會(huì )直接訪(fǎng)問(wèn) PyTypeObject.tp_weaklistoffset 成員。

  • PyObject_CheckBuffer() 宏已被轉換為函數：該宏會(huì )直接訪(fǎng)問(wèn) PyTypeObject.tp_as_buffer 成員。

  • 現在 PyIndex_Check() 總是被聲明為不透明函數以隱藏實(shí)現細節；PyIndex_Check() 宏已被移除。 該宏會(huì )直接訪(fǎng)問(wèn) PyTypeObject.tp_as_number 成員。

  （詳情請參閱 bpo-40170。）

移除?

• pyfpe.h 的 PyFPE_START_PROTECT() 和 PyFPE_END_PROTECT() 宏已從受限的 C API 中被排除。 （由 Victor Stinner 在 bpo-38835 中貢獻。）

• PyTypeObject 的 tp_print 空位已被移除。 它在 Python 2.7 及之前的版本中被用來(lái)將對象打印到文件。 自 Python 3.0 起，它已被忽略并且不再使用。 （由 Jeroen Demeyer 在 bpo-36974 中貢獻。）

• 受限 C API 中的改變（如果定義了 Py_LIMITED_API 宏）:

  • 以下函數已從受限 C API 中排除:

    • PyThreadState_DeleteCurrent() （由 Joannah Nanjekye 在 bpo-37878 中貢獻。）

    • _Py_CheckRecursionLimit

    • _Py_NewReference()

    • _Py_ForgetReference()

    • _PyTraceMalloc_NewReference()

    • _Py_GetRefTotal()

    • 在受限 C API 中從未使用的垃圾箱機制。

    • PyTrash_UNWIND_LEVEL

    • Py_TRASHCAN_BEGIN_CONDITION

    • Py_TRASHCAN_BEGIN

    • Py_TRASHCAN_END

    • Py_TRASHCAN_SAFE_BEGIN

    • Py_TRASHCAN_SAFE_END

  • 已將下列函數和定義移至內部 C API:

    • _PyDebug_PrintTotalRefs()

    • _Py_PrintReferences()

    • _Py_PrintReferenceAddresses()

    • _Py_tracemalloc_config

    • _Py_AddToAllObjects() (Py_TRACE_REFS 構建專(zhuān)屬)

  （由 Victor Stinner 在 bpo-38644 和 bpo-39542 中貢獻。）

• 移除了 _PyRuntime.getframe 鉤子并移除了 _PyThreadState_GetFrame 宏，該宏是 _PyRuntime.getframe 的一個(gè)別名。 它們僅由內部 C API 對外公開(kāi)。 同樣地移除了 PyThreadFrameGetter 類(lèi)型。 （由 Victor Stinner 在 bpo-39946 中貢獻。）

• 從 C API 移除了下列函數。 請顯式地調用 PyGC_Collect() 來(lái)清空所有自由列表。 （由 Inada Naoki 和 Victor Stinner 在 bpo-37340, bpo-38896 和 bpo-40428 中貢獻。）

  • PyAsyncGen_ClearFreeLists()

  • PyContext_ClearFreeList()

  • PyDict_ClearFreeList()

  • PyFloat_ClearFreeList()

  • PyFrame_ClearFreeList()

  • PyList_ClearFreeList()

  • PyMethod_ClearFreeList() 和 PyCFunction_ClearFreeList(): 綁定方法對象的自由列表已被移除。

  • PySet_ClearFreeList(): 集合自由列表已在 Python 3.4 中被移除。

  • PyTuple_ClearFreeList()

  • PyUnicode_ClearFreeList(): Unicode 自由列表已在 Python 3.3 中被移除。

• 移除了 _PyUnicode_ClearStaticStrings() 函數。 （由 Victor Stinner 在 bpo-39465 中貢獻。）

• 移除了 Py_UNICODE_MATCH。 它已被 PEP 393 所棄用，并自 Python 3.3 起不再可用。 可以改用 PyUnicode_Tailmatch() 函數。 （由 Inada Naoki 在 bpo-36346 中貢獻。）

• 清除了已定義但未實(shí)現的接口的頭文件。 被移除了公共 API 符號有: _PyBytes_InsertThousandsGroupingLocale, _PyBytes_InsertThousandsGrouping, _Py_InitializeFromArgs, _Py_InitializeFromWideArgs, _PyFloat_Repr, _PyFloat_Digits, _PyFloat_DigitsInit, PyFrame_ExtendStack, _PyAIterWrapper_Type, PyNullImporter_Type, PyCmpWrapper_Type, PySortWrapper_Type, PyNoArgsFunction。 （由 Pablo Galindo Salgado 在 bpo-39372 中貢獻。）

typing?

typing.Literal 的行為被改為遵循 PEP 586 并匹配該 PEP 所描述的靜態(tài)類(lèi)型檢查器的行為。

1. Literal 現在將是去重復的形參。

2. Literal 對象間的相等性比較現在將是順序無(wú)關(guān)的。

3. Literal 比較現在會(huì )考慮類(lèi)型。 例如 Literal[0] == Literal[False] 之前的結果值為 True。 現在則為 False。 為支持此改變，內部使用的類(lèi)型緩存現在也支持區分類(lèi)型。

4. 現在如果有任何一個(gè)參數不為 hashable，Literal 對象將在相等性比較期間引發(fā) TypeError。 請注意使用可變參數聲明 Literal 將不會(huì )拋出異常:

   >>>

   >>> from typing import Literal
   >>> Literal[{0}]
   >>> Literal[{0}] == Literal[{False}]
   Traceback (most recent call last):
     File "<stdin>", line 1, in <module>
   TypeError: unhashable type: 'set'
   

（由 Yurii Karabas 在 bpo-42345 中貢獻。）

macOS 11.0 (Big Sur) 與 Apple Silicon Mac 支持?

對于 3.9.1 版來(lái)說(shuō)，Python 現在完全支持在 macOS 11.0 (Big Sur) 和 Apple Silicon Macs (基于 ARM64 架構) 上構建和運行。 現在提供了一個(gè)新的通用構建類(lèi)型 universal2，用于在一組可執行文件上原生支持 ARM64 和 Intel 64。 二進(jìn)制文件現在也可以在當前版本的 macOS 上編譯以部署到多種較舊的 macOS 版本上 (已測試 10.9)，同時(shí)會(huì )基于運行時(shí)所使用的操作系統版本讓某些較新的 OS 功能和選項有條件地可用 ("弱鏈接") 。

（由 Ronald Oussoren 和 Lawrence D'Anna 在 bpo-41100 中貢獻。）

collections.abc?

現在 collections.abc.Callable 泛型會(huì )將類(lèi)型形參展平，類(lèi)似于 typing.Callable 當前所做的那樣。 這意味著(zhù) collections.abc.Callable[[int, str], str] 的 __args__ 將為 (int, str, str)；之前則為 ([int, str], str)。 為了允許這個(gè)改變，types.GenericAlias 現在可以被子類(lèi)化，并且在抽取 collections.abc.Callable 類(lèi)型時(shí)將返回一個(gè)子類(lèi)。 通過(guò) typing.get_args() 或 __args__ 訪(fǎng)問(wèn)參數的代碼需要考慮到這個(gè)改變。 對于無(wú)效的 collections.abc.Callable 參數化形式可能會(huì )發(fā)出 DeprecationWarning，這在 Python 3.9.1 中可能會(huì )靜默地傳遞。 這個(gè) DeprecationWarning 將在 Python 3.10 中變?yōu)?TypeError。 （由 Ken Jin 在 bpo-42195 中貢獻。）

urllib.parse?

早先的 Python 版本允許使用 ; 和 & 作為 urllib.parse.parse_qs() 和 urllib.parse.parse_qsl() 中 query 形參的分隔鍵。 出于安全考慮，也為了遵循更新的 W3C 推薦設置，這已被改為只允許單個(gè)分隔鍵，默認為 &。 這一改變還會(huì )影響 cgi.parse() 和 cgi.parse_multipart() 因為它們在內部使用了受影響的函數。 要了解更多細節，請查看它們各自的文檔。 （由 Adam Goldschmidt, Senthil Kumaran 和 Ken Jin 在 bpo-42967 中貢獻。）