Python 3.9 有什么新變化?

字典合并與更新運(yùn)算符?

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

示例:

>>> 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'}

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

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

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

標(biāo)準(zhǔn)多項(xiàng)集中的類型標(biāo)注泛型?

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

示例:

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

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

新的解析器?

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

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

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

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

zoneinfo?

zoneinfo 模塊為標(biāo)準(zhǔn)庫引入了 IANA 時區(qū)數(shù)據(jù)庫。 它添加了 zoneinfo.ZoneInfo，這是一個基于系統(tǒng)時區(qū)數(shù)據(jù)的實(shí)體 datetime.tzinfo 實(shí)現(xiàn)。

示例:

>>> 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 數(shù)據(jù)庫的平臺的一個回退數(shù)據(jù)源，還以第一方軟件包的形式發(fā)布了 tzdata 模塊 -- 通過 PyPI 發(fā)行并由 CPython 核心團(tuán)隊(duì)維護(hù)。

graphlib?

添加了新的 graphlib 模塊，其中包含 graphlib.TopologicalSorter 類來提供圖的拓?fù)渑判蚬δ堋?（由 Pablo Galindo, Tim Peters 和 Larry Hastings 在 bpo-17005 中貢獻(xiàn)。）

ast?

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

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

為 AST 節(jié)點(diǎn)添加了文檔字符串，其中包含 ASDL 簽名，可被用來構(gòu)造對應(yīng)的節(jié)點(diǎn)。 （由 Batuhan Taskaya 在 bpo-39638 中貢獻(xiàn)。）

asyncio?

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

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

添加了 asyncio.PidfdChildWatcher，這是一個 Linux 專屬的子監(jiān)視器實(shí)現(xiàn)，它負(fù)責(zé)輪詢進(jìn)程的文件描述符。 (bpo-38692)

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

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

當(dāng)附帶 ssl.SSLSocket 套接字調(diào)用不兼容的方法時 asyncio 現(xiàn)在會引發(fā) TyperError。 （由 Ido Michael 在 bpo-37404 中貢獻(xiàn)。）

compileall?

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

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

concurrent.futures?

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

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

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

curses?

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

datetime?

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

distutils?

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

fcntl?

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

ftplib?

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

gc?

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

增加了一個新的函數(shù) gc.is_finalized() 用來檢測一個對象是否已被垃圾回收器所終結(jié)。 （由 Pablo Galindo 在 bpo-39322 中貢獻(xiàn)。）

hashlib?

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

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

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 中貢獻(xiàn)。）

IDLE 與 idlelib?

添加了切換光標(biāo)閃爍停止的選項(xiàng)。 （由 Zackery Spytz 在 bpo-4603 中貢獻(xiàn)。）

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

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

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 維護(hù)發(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?

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

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

importlib?

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

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

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

來自 importlib_metadata 1.6.1 版的已更新 importlib.metadata。

inspect?

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

ipaddress?

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

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

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

math?

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

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

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

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

multiprocessing?

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

nntplib?

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

os?

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

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

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

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

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

pathlib?

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

pdb?

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

poplib?

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

pprint?

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

pydoc?

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

random?

增加了新的 random.Random.randbytes 方法：生成隨機(jī)字節(jié)串。 （由 Victor Stinner 在 bpo-40286 中貢獻(xiàn)。）

signal?

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

smtplib?

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

現(xiàn)在 LMTP 構(gòu)造器具有可選的 timeout 形參。 （由 Dong-hee Na 在 bpo-39329 中貢獻(xiàn)。）

socket?

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

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

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

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 屬性：平臺專屬庫目錄的名稱。 它被用于構(gòu)建標(biāo)準(zhǔn)庫的路徑以及已安裝擴(kuò)展模塊的路徑。 它在大多數(shù)平臺上等于 "lib"。 在 Fedora 和 SuSE 上，它等于 64 位平臺上的 "lib64"。 （由 Jan Matějek, Matěj Cepl, Charalampos Stratakis 和 Victor Stinner 在 bpo-1294959 中貢獻(xiàn)。）

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

tracemalloc?

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

typing?

PEP 593 引入了一種 typing.Annotated 類型以使用上下文專屬的元數(shù)據(jù)來裝飾現(xiàn)有類型，并將新的 include_extras 形參添加到 typing.get_type_hints() 以在運(yùn)行時訪問元數(shù)據(jù)。 （由 Till Varoquaux 和 Konstantin Kashin 貢獻(xiàn)。）

unicodedata?

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

venv?

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

xml?

當(dāng)把 xml.etree.ElementTree 序列化為 XML 文件時屬性內(nèi)部的空白字符現(xiàn)在將被保留。 不同的行結(jié)束符不會再被正規(guī)化為 "n"。 這是對于如何解讀 XML 規(guī)范 2.11 節(jié)的相關(guān)討論的最終結(jié)果。 （由 Mefistotelis 在 bpo-39011 中貢獻(xiàn)。）

Python API 的變化?

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

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

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

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

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

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

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

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

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

• array('u') 現(xiàn)在使用 wchar_t 作為 C 類型而不是 Py_UNICODE。 這個改變不會影響其行為，因?yàn)樽?Python 3.3 起 Py_UNICODE 是 wchar_t 的別名。 （由 Inada Naoki 在 bpo-34538 中貢獻(xiàn)。）

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

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

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

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

C API 的變化?

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

  示例:

  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
  }
  

  如果你的遍歷函數(shù)委托給了其基類（或其他類）的 tp_traverse，則要確保 Py_TYPE(self) 只被訪問一次。 請注意應(yīng)當(dāng)只有 堆類型 可訪問 tp_traverse 中的類型。

  舉例來說，如果你的 tp_traverse 函數(shù)包括以下內(nèi)容:

  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 函數(shù)已被棄用。 請改用 PyObject_Call() 及其變化形式。 （詳情參見 bpo-29548。）

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

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

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

  • COMPARE_OP 用于富比較

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

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

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

  （由 Mark Shannon 在 bpo-39156 中貢獻(xiàn)。）

新的特性?

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

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

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

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

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

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

  • 提供 Py_EnterRecursiveCall() 和 Py_LeaveRecursiveCall() 作為常規(guī)函數(shù)用于受限 API。 在之前版本中是使用宏定義，但這些宏不能與無法訪問 PyThreadState.recursion_depth 字段的受限 C API 一同編譯（該結(jié)構(gòu)體在受限 C API 中是不透明的）。

  • PyObject_INIT() 和 PyObject_INIT_VAR() 已成為常規(guī)“不透明”函數(shù)以隱藏實(shí)現(xiàn)細(xì)節(jié)。

  （由 Victor Stinner 在 bpo-38644 和 bpo-39542 中貢獻(xiàn)。）

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

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

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

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

移植到 Python 3.9?

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

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

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

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

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

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

• 現(xiàn)在 PyGC_Head 結(jié)構(gòu)是不透明的。 它只在內(nèi)部 C API (pycore_gc.h) 中定義。 （由 Victor Stinner 在 bpo-40241 中貢獻(xiàn)。）

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

• Py_FatalError() 函數(shù)會被一個自動記錄當(dāng)前函數(shù)名稱的宏所替代，除非已定義了 Py_LIMITED_API 宏。 （由 Victor Stinner 在 bpo-39882 中貢獻(xiàn)。）

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

• 多個宏和函數(shù)的實(shí)現(xiàn)細(xì)節(jié)現(xiàn)在已被隱藏:

  • PyObject_IS_GC() 宏已被轉(zhuǎn)換為函數(shù)。

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

  • PyObject_GET_WEAKREFS_LISTPTR() 宏已被轉(zhuǎn)換為函數(shù)：該宏會直接訪問 PyTypeObject.tp_weaklistoffset 成員。

  • PyObject_CheckBuffer() 宏已被轉(zhuǎn)換為函數(shù)：該宏會直接訪問 PyTypeObject.tp_as_buffer 成員。

  • 現(xiàn)在 PyIndex_Check() 總是被聲明為不透明函數(shù)以隱藏實(shí)現(xiàn)細(xì)節(jié)；PyIndex_Check() 宏已被移除。 該宏會直接訪問 PyTypeObject.tp_as_number 成員。

  （詳情請參閱 bpo-40170。）

移除?

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

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

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

  • 以下函數(shù)已從受限 C API 中排除:

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

    • _Py_CheckRecursionLimit

    • _Py_NewReference()

    • _Py_ForgetReference()

    • _PyTraceMalloc_NewReference()

    • _Py_GetRefTotal()

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

    • PyTrash_UNWIND_LEVEL

    • Py_TRASHCAN_BEGIN_CONDITION

    • Py_TRASHCAN_BEGIN

    • Py_TRASHCAN_END

    • Py_TRASHCAN_SAFE_BEGIN

    • Py_TRASHCAN_SAFE_END

  • 已將下列函數(shù)和定義移至內(nèi)部 C API:

    • _PyDebug_PrintTotalRefs()

    • _Py_PrintReferences()

    • _Py_PrintReferenceAddresses()

    • _Py_tracemalloc_config

    • _Py_AddToAllObjects() (Py_TRACE_REFS 構(gòu)建專屬)

  （由 Victor Stinner 在 bpo-38644 和 bpo-39542 中貢獻(xiàn)。）

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

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

  • 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() 函數(shù)。 （由 Victor Stinner 在 bpo-39465 中貢獻(xiàn)。）

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

• 清除了已定義但未實(shí)現(xiàn)的接口的頭文件。 被移除了公共 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 中貢獻(xiàn)。）

typing?

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

1. Literal 現(xiàn)在將是去重復(fù)的形參。

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

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

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

   >>>

   >>> 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 中貢獻(xiàn)。）

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

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

（由 Ronald Oussoren 和 Lawrence D'Anna 在 bpo-41100 中貢獻(xiàn)。）

collections.abc?

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

urllib.parse?

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