PEP 657：回溯 (traceback) 中更細緻的錯誤位置¶

當要印出回溯，直譯器現在會指出造成錯誤的確切運算式，而非只說明是哪一行。例如：

Traceback(mostrecentcalllast):File"distance.py",line11,in<module>print(manhattan_distance(p1,p2))^^^^^^^^^^^^^^^^^^^^^^^^^^File"distance.py",line6,inmanhattan_distancereturnabs(point_1.x-point_2.x)+abs(point_1.y-point_2.y)^^^^^^^^^AttributeError:'NoneType'objecthasnoattribute'x'

前一版本的直譯器只會標明是哪一行，無法辨認哪一個物件是None。當處理多層的巢狀dict 物件和多個函式呼叫時，這種強化錯誤提示也可能非常有用：

Traceback(mostrecentcalllast):File"query.py",line37,in<module>magic_arithmetic('foo')File"query.py",line18,inmagic_arithmeticreturnadd_counts(x)/25^^^^^^^^^^^^^File"query.py",line24,inadd_countsreturn25+query_user(user1)+query_user(user2)^^^^^^^^^^^^^^^^^File"query.py",line32,inquery_userreturn1+query_count(db,response['a']['b']['c']['user'],retry=True)~~~~~~~~~~~~~~~~~~^^^^^TypeError:'NoneType'objectisnotsubscriptable

在複雜的計算運算式中也是：

Traceback(mostrecentcalllast):File"calculation.py",line54,in<module>result=(x/y/z)*(a/b/c)~~~~~~^~~ZeroDivisionError:divisionbyzero

此外，強化回溯特性所使用的資訊可以透過一般的 API 來取得，以用來使bytecode指示 (instruction)與原始碼位置相互關聯。此項資訊可以用以下方式取得：

• Python 中的codeobject.co_positions() 方法。

• C API 中的PyCode_Addr2Location() 函式。

詳情請見PEP 657。（由 Pablo Galindo、Batuhan Taskaya 與 Ammar Askar 於bpo-43950 中所貢獻。）

PEP 654：例外群組與except*¶

PEP 654 引入了新的的語言特性，可讓程式同時引發並處理多個相互無關的例外。內建型別ExceptionGroup 和BaseExceptionGroup 使得程式可為多個例外組成群組並同時引發，新的except* 語法也將except 泛用化、能夠比對例外群組的子群組。

詳情請見PEP 654。

（由 Irit Katriel 於bpo-45292 中所貢獻。PEP 由 Irit Katriel、Yury Selivanov 與 Guido van Rossum 撰寫。）

PEP 678：運用例外註解使其更加詳盡¶

新增add_note() 方法到BaseException。當上下文資訊在例外被引發時無法被取得，這個方法就可以用來為例外添加更多資訊。被添加的註解會在預設回溯中出現。

詳情請見PEP 678。

（由 Irit Katriel 於bpo-45607 中所貢獻。PEP 由 Zac Hatfield-Dodds 所撰寫）

Windowspy.exe 啟動程式 (launcher) 的改進¶

Python 3.11 所包含的Python Launcher for Windows 複製品有了顯著的改善。它現在支援PEP 514 所定義的公司/標籤 (tag) 語法，可用-V:<company>/<tag> 引數來取代受限的-<major>.<minor>。這允許了python.org 上的PythonCore 以外的發行版本發布。

使用-V: 選擇器時，可以省略公司或標籤，但會搜尋所有安裝。例如，-V:OtherPython/ 將選擇OtherPython 註冊的「最佳」標籤，而-V:3.11 或-V:/3.11 將選擇帶有3.11 標籤的「最佳」發行版。

當使用遺留的-<major>、-<major>.<minor>、-<major>-<bitness> 或-<major>.<minor>-<bitness> 引數時，所有過去版本的行為都應該保留下來，且只有PythonCore 中的發布版本會被選用。然而，-64 後綴現在暗示了「非 32-bit」（不用一定要是 x86-64），因為現在有多個支援 64-bit 的平台。32-bit 運行程式會在檢查運行程式之標籤是否帶有-32 後綴時被偵測出來。所有 Python 3.5 以後發布版本的 32-bit 建置中都有這個行為。

PEP 646：可變參數泛型 (variadic generics)¶

PEP 484 先前引入了TypeVar，開啟了帶有單一型別的泛型參數化。PEP 646 新增TypeVarTuple，開啟了帶有任意數量型別的參數化 (parameterisation)。換句話說，TypeVarTuple 是可變的型別變數，啟用了可變的泛型。

這使其有非常多用例，特別是它允許了像是 NumPy 和 Tensorflow 的數值運算函式庫中類似陣列結構的型別可用shape 陣列來被參數化。靜態型別檢查工具現在也能夠為使用這些函式庫的程式捕捉到維度相關的錯誤。

詳情請見PEP 646。

（由 Matthew Rahtz 於bpo-43224 中所貢獻，由 Serhiy Storchaka 與 Jelle Zijlstra 協助。PEP 由 Mark Mendoza、Matthew Rahtz、Pradeep Kumar Srinivasan 與 Vincent Siles 所撰寫）

PEP 655：標記獨立TypedDict 項目為必要或不必要¶

Required 與NotRequired 提供了標記一個獨立項目在TypedDict 中是否必須存在的直覺方法。在這之前，這只有透過繼承才有可能做得到。

所有欄位都預設為是必要的，除非total 參數有被設為False，那麼所有欄位就會是非必要的。例如，這個範例指定了要有一個必要鍵與一個非必要鍵的TypedDict：

classMovie(TypedDict):title:stryear:NotRequired[int]m1:Movie={"title":"Black Panther","year":2018}# OKm2:Movie={"title":"Star Wars"}# OK (year is not required)m3:Movie={"year":2022}# ERROR (missing required field title)

以下定義等同於：

classMovie(TypedDict,total=False):title:Required[str]year:int

詳情請見PEP 655。

（由 David Foster 與 Jelle Zijlstra 於bpo-47087 中所貢獻。PEP 由 David Foster 所撰寫）

PEP 673：Self 型別¶

新的Self 標註提供了一種簡單直觀的方法來標註那些會回傳其類別實例的方法。這與PEP 484 中指定的基於TypeVar 的方法相同，但更簡潔且更易於遵循。

常見用例包括作為classmethod 的替代建構函式和會回傳self 的__enter__() 方法：

classMyLock:def__enter__(self)->Self:self.lock()returnself...classMyInt:@classmethoddeffromhex(cls,s:str)->Self:returncls(int(s,16))...

Self 也可用於標註與其封閉類類別 (enclosing class) 相同的方法參數或屬性。

詳情請見PEP 673。

（由 James Hilton-Balfe 於bpo-46534 中所貢獻。PEP 由 Pradeep Kumar Srinivasan 與 James Hilton-Balfe 所撰寫）

PEP 675：任意的文本字串型別 (Arbitrary literal string type)¶

新的LiteralString 標註可用於標示一個函式參數可為任何文本字串型別 (literal string type)。這允許函式接受任意的文本字串型別，以及從其他文本字串建立的字串。型別檢查器就可以強制需審慎處理的函式（例如會執行 SQL 陳述式或 shell 命令的函式）僅會以靜態引數呼叫，從而提供針對注入攻擊的保護。

例如一個 SQL 查詢函式 (query function) 可以被標註為：

defrun_query(sql:LiteralString)->......defcaller(arbitrary_string:str,query_string:LiteralString,table_name:LiteralString,)->None:run_query("SELECT * FROM students")# okrun_query(query_string)# okrun_query("SELECT * FROM "+table_name)# okrun_query(arbitrary_string)# type checker errorrun_query(# type checker errorf"SELECT * FROM students WHERE name ={arbitrary_string}")

詳情請見PEP 675。

（由 Jelle Zijlstra 於bpo-47088 中所貢獻。PEP 由 Pradeep Kumar Srinivasan 與 Graham Bleaney 所撰寫）

PEP 681：資料類別轉換 (Data class transforms)¶

dataclass_transform 可以用來裝飾一個類別、元類別 (metaclass)、或是一個本身就是裝飾器的函式。@dataclass_transform() 的存在會讓一個靜態型別檢查器知道被裝飾物件會在運行程式做出轉換類別的「魔法」，賦予其類似dataclass 的行為。

舉例來說：

# The create_model decorator is defined by a library.@typing.dataclass_transform()defcreate_model(cls:Type[T])->Type[T]:cls.__init__=...cls.__eq__=...cls.__ne__=...returncls# The create_model decorator can now be used to create new model classes:@create_modelclassCustomerModel:id:intname:strc=CustomerModel(id=327,name="Eric Idle")

詳情請見PEP 681。

（由 Jelle Zijlstra 於gh-91860 中所貢獻。PEP 由 Erik De Bonte 與 Eric Traut 所撰寫）

PEP 563 可能不是未來¶

PEP 563 推遲對註釋的求值 (Postponed Evaluation of Annotations)（from__future__importannotationsfuture 陳述式）最初計劃在 Python 3.10 中發布，但已被無限期擱置。請參閱來自指導委員會 (Steering Counsil) 的訊息以獲得更多資訊。

asyncio¶

• 添加了TaskGroup 類別，為一個會持有任務群組並在退出時等待全部完成的非同步情境管理器 (asynchronous context manager)。對於新程式碼，建議直接使用create_task() 和gather()。（由 Yury Selivanov 和其他人在gh-90908 中貢獻。）

• 新增timeout()，是一個用來為一個非同步操作設置超時的非同步情境管理器，新的程式建議直接使用它以取代wait_for()。（由 Andrew Svetlov 於gh-90927 貢獻。）

• 新增Runner 類別，它會對外公布了run() 的使用機制。（由 Andrew Svetlov 於gh-91218 貢獻。）

• 於 asyncio 函式庫的同步化原始物件中新增Barrier 類別與和其相關的BrokenBarrierError 例外。（由 Yves Duprat 和 Andrew Svetlov ingh-87518 貢獻。）

• 在asyncio.loop.create_connection() 新增關鍵字引數all_errors，這樣多個連接錯誤就可以一起用一個ExceptionGroup 來引發。

• 新增asyncio.StreamWriter.start_tls() 方法，用來將已存在的串流連線升級至 TLS。（由 Ian Good 於bpo-34975 中貢獻。）

• 在事件迴圈增加原始資料元 (raw datagram) socket 函式：sock_sendto()、sock_recvfrom() 和sock_recvfrom_into()。以上在SelectorEventLoop 和ProactorEventLoop 中都有實作。（由 Alex Grönholm 在bpo-46805 中貢獻。）

• 於Task 新增cancelling() 和uncancel() 方法。這些預期是只用於內部，尤其是TaskGroup。

contextlib¶

• 添加了非平行安全的chdir() 情境管理器來更改目前工作目錄，然後在退出時恢復它。chdir() 的簡單包裝器。（由 Filipe Laíns 在bpo-25625 中貢獻）

dataclasses¶

• 更改欄位預設的可變性檢查 (mutability check)，僅允許預設值是hashable 而不是任何非dict、list 或set 實例的物件。（由 Eric V. Smith 在bpo-44674 中貢獻。）

datetime¶

• 新增datetime.UTC，一個datetime.timezone.utc 的方便別名。（由 Kabir Kwatra 於gh-91973 所貢獻。）

• datetime.date.fromisoformat()、datetime.time.fromisoformat() 和datetime.datetime.fromisoformat() 現在可以用來剖析大部分的 ISO 8601 格式（除了那些支援分數形式的小時與分鐘）。（由 Paul Ganssle 於gh-80010 中所貢獻。）

enum¶

• EnumMeta 更名為EnumType（EnumMeta 保留為別名）。

• 增加StrEnum，列舉 (enum) 內的成員必須是字串。

• 新增ReprEnum，它只修改成員的__repr__()，同時回傳成員的文本值 (literal value)（而不是名稱），以用於（為str()、format() 和f-string 所使用的）__str__() 和__format__()。

• 改變了Enum.__format__() （被format()、str.format() 和f-string 預設使用），以使其與enum.Enum.__str__ 產生相同結果：對於繼承自ReprEnum 的列舉，這會是成員之值；而其他的列舉會是列舉與成員名稱（例如Color.RED）。

• 新增boundary 類別參數與其選項到Flag 列舉和FlagBoundary 列舉以控制處理超出範圍旗標數值的方法。

• 新增了verify() 列舉裝飾器和EnumCheck 列舉及其選項，以根據幾個特定限制檢查列舉類別。

• 新增member() 與nonmember() 裝飾器以確保被裝飾的物件會/不會被轉換成一個列舉成員。

• 新增property() 裝飾器，它的作用類似property() 但是是用於列舉，用以替代types.DynamicClassAttribute()。

• 新增global_enum() 列舉裝飾器，用來調整__repr__() 和__str__() 以模組成員形式而非列舉類別來顯示值。例如，re.RegexFlag 的ASCII 成員的're.ASCII'，而非'RegexFlag.ASCII'。

• 強化Flag 以支援使用len()、疊代 (iteration) 和in/notin 於其成員。例如，以下程式現在能夠作用了：len(AFlag(3))==2andlist(AFlag(3))==(AFlag.ONE,AFlag.TWO)

• 更改了Enum 和Flag 以在呼叫__init_subclass__() 之前就定義成員；dir() 現在包括來自混合資料型別的方法。

• 更改Flag 以僅考慮主要值（2 的次方）規範，而複合值（3、6、10 等）被視為別名；倒置旗標 (inverted flags) 會被強制轉換為正等價的值。

fcntl¶

• FreeBSD 上，F_DUP2FD 和F_DUP2FD_CLOEXEC 旗標分別有被支援，前者等同於dup2 用法，而後者設定了FD_CLOEXEC 旗標。

fractions¶

• 支援有PEP 515 風格的Fraction 以字串初始化。（Sergey B Kirpichev 於bpo-44258 中所貢獻。）

• Fraction 現在有實作了一個__int__ 方法，因此isinstance(some_fraction,typing.SupportsInt) 的檢查會通過。（由 Mark Dickinson 在bpo-44547 中貢獻。）

functools¶

• functools.singledispatch() 現在支援types.UnionType 和typing.Union 作為調度 (dispatch) 引數的標註。

  >>>fromfunctoolsimportsingledispatch>>>@singledispatch...deffun(arg,verbose=False):...ifverbose:...print("Let me just say,",end=" ")...print(arg)...>>>@fun.register...def_(arg:int|float,verbose=False):...ifverbose:...print("Strength in numbers, eh?",end=" ")...print(arg)...>>>fromtypingimportUnion>>>@fun.register...def_(arg:Union[list,set],verbose=False):...ifverbose:...print("Enumerate this:")...fori,eleminenumerate(arg):...print(i,elem)...

  （由 Yurii Karabas 於bpo-46014 中所貢獻。）

gzip¶

• Thegzip.compress() function is now faster when used with themtime=0 argument as it delegates the compression entirely to a singlezlib.compress() operation. There is one side effect of this change: Thegzip file header contains an "OS" byte in its header. That was traditionallyalways set to a value of 255 representing "unknown" by thegzipmodule. Now, when usingcompress() withmtime=0, it may beset to a different value by the underlying zlib C library Python was linkedagainst.(Seegh-112346 for details on the side effect.)

hashlib¶

• hashlib.blake2b() 與hashlib.blake2s() 現在偏好使用libb2 多於 Python 自發行版的複製。（由 Christian Heimes 於bpo-47095 中所貢獻。）

• 帶有 SHA3 和 SHAKE 演算法的內部_sha3 模組現在使用tiny_sha3 而不是Keccak 程式碼套件來減少程式碼和二進位檔案大小。hashlib 模組更喜歡來自 OpenSSL 的 SHA3 和 SHAKE 最佳化實作。此更改僅影響沒有 OpenSSL 支援的安裝。（由 Christian Heimes 在bpo-47098 中貢獻。）

• 新增hashlib.file_digest()，是個能夠為檔案或類檔案物件做高效率雜湊的幫助函式。（由 Christian Heimes 於gh-89313 中貢獻。）

IDLE 與 idlelib¶

• 在.pyi 檔案施用語法突顯 (syntax highlight)。（由 Alex Waygood 與 Terry Jan Reedy 於bpo-45447 中所貢獻。）

• 當帶有輸入與輸出地儲存 Shell 時，也會包含提示字元。（由 Terry Jan Reedy 於gh-95191 中所貢獻。）

inspect¶

• 添加getmembers_static() 以回傳所有成員，而不會通過描述器協議 (descriptor protocol) 觸發動態查找。（由 Weipeng Hong 在bpo-30533 中貢獻。）

• 新增inspect.ismethodwrapper()，用來檢查一個物件的型別是否為MethodWrapperType。（由 Hakan Çelik 於bpo-29418 中所貢獻。）

• 更改inspect 模組中與幀相關的函式以回傳新的FrameInfo 和Traceback 類別實例（向後相容之前類似於named tuple 的介面），包括擴充的PEP 657 位置資訊（結束行號、欄和結束欄）。受影響的功能是：

  • inspect.getframeinfo()

  • inspect.getouterframes()

  • inspect.getinnerframes(),

  • inspect.stack()

  • inspect.trace()

  （由 Pablo Galindo 於gh-88116 中所貢獻。）

locale¶

• 新增locale.getencoding() 以取得目前的區域編碼 (locale encoding)。和locale.getpreferredencoding(False) 類似但不考慮Python UTF-8 模式。

logging¶

• 新增getLevelNamesMapping() 以回傳一個日誌級別名稱（例如'CRITICAL'）指到對應的Logging Levels 數值（例如，預設為50）的對映。（由 Andrei Kulakovin 於gh-88024 中貢獻。）

• 添加了一個createSocket() 方法到SysLogHandler，以匹配SocketHandler.createSocket() 。如果沒有已啟用的 socket，它會在處理程式初始化期間和發出一個事件時自動呼叫。（由 Kirill Pinchuk 在gh-88457 中貢獻。）

math¶

• 新增math.exp2()：回傳 2 的 x 次方。（由 Gideon Mitchell 於bpo-45917 中所貢獻。）

• 新增math.cbrt()：回傳 x 的立方根。（由 Ajith Ramachandran 於bpo-44357 中所貢獻。）

• 為了與 IEEE 754 規範保持一致，更改了兩個math.pow() 邊角案例 (corner case) 的行為。math.pow(0.0,-math.inf) 和math.pow(-0.0,-math.inf) 現在回傳inf，之前它們會引發ValueError。（由 Mark Dickinson 在bpo-44339 中貢獻。）

• math.nan 現為隨時可用。（由 Victor Stinner 於bpo-46917 中所貢獻。）

operator¶

• 新增operator.call 函式，使得operator.call(obj,*args,**kwargs)==obj(*args,**kwargs)。（由 Antony Lee 於bpo-44019 中所貢獻。）

os¶

• 在 Windows 上，os.urandom() 現在使用BCryptGenRandom() 以取代被棄用的CryptGenRandom()。（由 Donghee Na 於bpo-44611 中所貢獻。）

pathlib¶

• 如果pattern 以路徑名稱元件分隔符號sep 或altsep 結尾，glob() 和rglob() 只回傳目錄。（由 Eisuke Kawasima 於bpo-22276 與bpo-33392 中所貢獻。）

re¶

• 現在規則運算式 (regular expression) 是有支援原子性群組 (atomic grouping) ((?>...)) 和佔有性量詞 (possessive quantifier) (*+,++,?+,{m,n}+) 的。（由 Jeffrey C. Jacobs 和 Serhiy Storchaka 在bpo-433030 中貢獻。）

shutil¶

• 新增shutil.rmtree() 的可選參數dir_fd。（由 Serhiy Storchaka 於bpo-46245 中所貢獻。）

socket¶

• 新增 NetBSD 對於 CAN Socket 的支援。（由 Thomas Klausner 於bpo-30512 中所貢獻。）

• 當連接失敗時，create_connection() 有個選項可以引發一個包含所有錯誤的ExceptionGroup，而非只引發最後一個錯誤。（由 Irit Katriel 於bpo-29980 中貢獻。）

sqlite3¶

• 現在可以透過將None 傳遞給set_authorizer() 來停用 authorizer。（由 Erlend E. Aasland 於bpo-44491 中貢獻。）

• 定序 (collation) 名稱create_collation() 現在可以包含任何 Unicode 字元。帶有無效字元的定序名稱現在會引發UnicodeEncodeError 而不是sqlite3.ProgrammingError。（由 Erlend E. Aasland 在bpo-44688 中貢獻。）

• sqlite3 例外現在包含 SQLite 擴充錯誤碼和 SQLite 錯誤名稱（分別為sqlite_errorcode 和sqlite_errorname）。（由 Aviv Palivoda、Daniel Shahaf 和 Erlend E. Aasland 在bpo-16379 和bpo-24139 中貢獻。）

• 將setlimit() 和getlimit() 新增到sqlite3.Connection 以根據連線來設定和取得 SQLite 限制。（由 Erlend E. Aasland 在bpo-45243 中貢獻。）

• sqlite3 現在會基於底層 SQLite 函式庫編譯時所使用的預設執行緒模式來設定sqlite3.threadsafety。（由 Erlend E. Aasland 在bpo-45613 中貢獻。）

• sqlite3 如果啟用回呼回溯 (callback traceback)，C 回呼現在使用無法被引發的例外。使用者現在可以註冊一個無法被引發的掛鈎處理程式(unraisablehookhandler) 來改善他們的除錯體驗。（由 Erlend E. Aasland 在bpo-45828 中貢獻。）

• 跨越不同回滾 (rollback) 的拿取動作不再引發InterfaceError，我們將其留給 SQLite 函式庫來處理這些情況。（由 Erlend E. Aasland 在bpo-44092 中貢獻。）

• 將serialize() 和deserialize() 新增到sqlite3.Connection 以用於序列化和反序列化資料庫。（由 Erlend E. Aasland 在bpo-41930 中貢獻。）

• 於sqlite3.Connection 加入create_window_function() 已建立聚合視窗函式 (aggregate window function)。（由 Erlend E. Aasland 於bpo-34916 中貢獻。）

• 在sqlite3.Connection 新增blobopen()。sqlite3.Blob 允許對 blob 進行增量 I/O 操作 (incremental I/O operations)。（由 Aviv Palivoda 和 Erlend E. Aasland 在bpo-24905 中貢獻。）

string¶

• 新增get_identifiers() 和is_valid() 於string.Template，分別能夠回傳所有合格的預留位置 (placeholder) 與是否有任何不合格的預留位置存在。（由 Ben Kehoe 於gh-90465 中貢獻。）

sys¶

• sys.exc_info() 現在從value（例外實例）衍生出type 和traceback 欄位，因此當例外在處理過程中被修改時，變更會反映在exc_info() 後續呼叫的結果中。（由 Irit Katriel 在bpo-45711 中貢獻。）

• 新增會回傳活躍例外實例 (active exception instance) 的sys.exception()（等價於sys.exc_info()[1]）。（由 Irit Katriel 於bpo-46328 中所貢獻。）

• 新增sys.flags.safe_path 旗標。（由 Victor Stinner 於gh-57684 中所貢獻。）

sysconfig¶

• 新增了三個安裝方案（posix_venv、nt_venv 和venv），它們在 Python 建立新的虛擬環境或在虛擬環境中執行環境使用。前兩個方案（posix_venv 和nt_venv）是非 Windows 和 Windows 作業系統所特有的，venv 本質上會根據 Python 運行的作業系統來做為其中之一的別名。這對修改sysconfig.get_preferred_scheme() 的下游發布者很有用。建立新虛擬環境的第三方程式碼應該使用新的venv 安裝方案來確定路徑，就像venv 一樣。（由 Miro Hrončok 在bpo-45413 中貢獻。）

tempfile¶

• SpooledTemporaryFile 物件現在完整實作了io.BufferedIOBase 或io.TextIOBase 的方法（取決於檔案模式），這使它們能夠正確地使用需要類檔案物件的 API，例如壓縮模組。（由 Carey Metcalfe 在gh-70363 中貢獻。）

threading¶

• 在 Unix 上，如果sem_clockwait() 函式在 C 函式庫（glibc 2.30 與其更新的版本）中可被使用，則threading.Lock.acquire() 方法現在會使用單調時鐘 (time.CLOCK_MONOTONIC) 用於超時 (timeout)，而不是使用系統時鐘 (time.CLOCK_REALTIME)，以免受系統時鐘變化的影響。 由 Victor Stinner 在bpo-41710 中貢獻。）

time¶

• 在 Unix 上，如果可用的話，time.sleep() 現在會使用clock_nanosleep() 或nanosleep() 函式，其解析度為 1 納秒（10^-9 秒），而不是使用解析度為 1 微秒（10^-6 秒）的select()。（由 Benjamin Szőke 和 Victor Stinner 在bpo-21302 中貢獻。）

• 在 Windows 8.1 或更新的平台上，time.sleep() 現在使用了一個基於高解析度計時器的可等待 (waitable) 計時器，解析度為 100 奈秒（即 10^-7 秒）。在這之前，它只有 1 微秒（10^-3 秒） 的解析度。（由 Benjamin Szőke、Donghee Na、Eryk Sun 和 Victor Stinner 於bpo-21302 與bpo-45429 中貢獻。）

tkinter¶

• 新增了info_patchlevel() 方法，它會回傳 Tcl 函式庫的確切版本以作為類似於sys.version_info 的附名元組。（由 Serhiy Storchaka 在gh-91827 中貢獻。）

traceback¶

• 新增traceback.StackSummary.format_frame_summary() 以允許使用者覆蓋回溯中出現的幀及它們的格式。（由 Ammar Askar 在bpo-44569 中貢獻。）

• 新增traceback.TracebackException.print()，它會印出格式化的TracebackException 實例至一個檔案。（由 Irit Katriel 在bpo-33809 中貢獻。）

typing¶

重大變更請見型別提示相關的新特性。

• 新增typing.assert_never() 和typing.Never。typing.assert_never() 可用於要型別檢查器確認某行程式碼是否不可觸及。在執行環境，它會引發AssertionError。（由 Jelle Zijlstra 在gh-90633 中貢獻。）

• 新增typing.reveal_type()，這可用於請求型別檢查器為給定運算式推斷出什麼型別。在執行環境它會印出接收到的值的型別。（由 Jelle Zijlstra 在gh-90572 中貢獻。）

• 新增typing.assert_type()，這可用於要型別檢查器確認它為給定運算式推斷的型別是否與給定型別相符。在執行環境，它只會回傳接收到的值。（由 Jelle Zijlstra 在gh-90638 中貢獻。）

• typing.TypedDict 型別現可為泛型。（由 Samodya Abeysiriwardane 於gh-89026 中所貢獻。）

• NamedTuple 型別現可為泛型。（由 Serhiy Storchaka 於bpo-43923 中所貢獻。）

• 允許繼承typing.Any，這能有效避免與高度動態類別（例如 mock）相關的型別檢查器錯誤。（由 Shantanu Jain 在gh-91154 中貢獻。）

• typing.final() 裝飾器現在會在被裝飾的物件上設定__final__ 屬性。（由 Serhiy Storchaka 於gh-90500 中所貢獻。）

• typing.get_overloads() 函式可用於自我檢查 (introspect) 一個函式的過載 (overload)。typing.clear_overloads() 可用於清除一個函式的所有已註冊過載。（由 Jelle Zijlstra 在gh-89263 中貢獻。）

• Protocol 子類別的__init__() 方法現在被保留。（由 Adrian Garcia Badarasco 在gh-88970 中貢獻。）

• 空元組型別 (Tuple[()]) 的表示法得到簡化，這會影響自我檢查 (introspection)，例如get_args(Tuple[()]) 的求值現在會是() 而不是((),)。（由 Serhiy Storchaka 在gh-91137 中貢獻。）

• 通過刪除私有typing._type_check 函式中的可呼叫檢查，放寬型別標註的執行環境要求。（由 Gregory Beauregard 在gh-90802 中貢獻。）

• 作為PEP 585 泛化別名中的前向參照，typing.get_type_hints() 現支援了為字串求值 (evaluate)。（由 Niklas Rosenstein 在gh-85542 中貢獻。）

• typing.get_type_hints() 不再將Optional 新增到預設為None 的參數中。（由 Nikita Sobolev 在gh-90353 中貢獻。）

• typing.get_type_hints() 現在支援為無修飾 (bare) 字串化 (stringified) 的ClassVar 標註來求值。（由 Gregory Beauregard 在gh-90711 中貢獻。）

• typing.no_type_check() 不再修改外部類別和函式。它現在也正確地將類別方法標記為不需進行型別檢查。（由 Nikita Sobolev 在gh-90729 中貢獻。）

unicodedata¶

• Unicode 資料庫被更新為 14.0.0 版本。（Benjamin Peterson 於bpo-45190 中所貢獻。）

unittest¶

• 新增TestCase 類別的enterContext() 與enterClassContext() 方法、IsolatedAsyncioTestCase 類別 的enterAsyncContext() 方法、unittest.enterModuleContext() 函式。（由 Serhiy Storchaka 於bpo-45046 貢獻。）

venv¶

• 建立新的 Python 虛擬環境時，venvsysconfig 安裝方案會被用於確定環境內的路徑。當 Python 在虛擬環境中運行時，預設使用相同的安裝方案。這意味著下游發布者可以在不改變虛擬環境行為的情況下更改預設的 sysconfig 安裝方案。建立新虛擬環境的第三方程式碼也應該這樣做。（由 Miro Hrončok 在bpo-45413 中貢獻。）

warnings¶

• warnings.catch_warnings() 現在接受warnings.simplefilter() 的引數，提供了一種更簡潔的方法來在本地端忽略警告或將它們轉換為錯誤。（由 Zac Hatfield-Dodds 在bpo-47074 中貢獻。）

zipfile¶

• 新增了對指定成員名稱編碼的支援，以便在ZipFile 的目錄和檔案標頭中讀取元資料 (metadata)。（由 Stephen J. Turnbull 和 Serhiy Storchaka 在bpo-28080 中貢獻。）

• 新增ZipFile.mkdir() 以在 ZIP 歸檔中建立新的目錄。（由 Sam Ezeh 於gh-49083 貢獻。）

• 於zipfile.Path 新增stem、suffix 和suffixes。（由 Miguel Brito 於gh-88261 貢獻。）

更快的啟動¶

Read __pycache__ -> Unmarshal -> Heap allocated code object -> Evaluate

Statically allocated code object -> Evaluate

更快的運行程式¶

雜項¶

• 物件現在因為使用了惰性建立的物件命名空間所以需要更少的記憶體。它們的命名空間字典現在也更自由地共享鍵。（由 Mark Shannon 於bpo-45340 和bpo-40116 貢獻。 ）

• 實作了「無代價 (Zero-cost)」的例外，消除了在沒有例外被引發時的try 陳述式開銷。（由 Mark Shannon 於bpo-40222 貢獻。）

• 在直譯器內使用更簡潔的例外表示法將捕獲一個例外所需的時間減少了大約 10%。 由 Irit Katriel 在bpo-45711 中貢獻。）

• re 的正規表示式比對引擎部分被重構，且現在會有支援的平台上使用 computed gotos（或者「執行緒程式碼 (threaded code)」），因此 Python 3.11 在執行pyperformance 正規表示式基準量測的表現上比起 Python 3.10 快了 10%。（由 Brandt Bucher 於gh-91404 中貢獻。）

FAQ¶

關於¶

CPython 加速計畫探索了各種CPython 最佳化的可能性。主要團隊由微軟 (microsoft) 所資助以全職發展該計畫，Pablo Galindo Salgado 亦由彭博有限合夥企業 (Bloomberg LP) 資助來兼職開發，更有許許多多來自社群的自發性貢獻者。

新增 opcode¶

• ASYNC_GEN_WRAP、RETURN_GENERATOR 和SEND 被用於產生器與協程。

• COPY_FREE_VARS，避免了為閉包 (closure) 而生的特殊呼叫方 (caller-side) 程式碼的需求。

• JUMP_BACKWARD_NO_INTERRUPT，用於某些不需要處理中斷的循環。

• MAKE_CELL 被用於建立Cell 物件。

• CHECK_EG_MATCH 和PREP_RERAISE_STAR，處理PEP 654 所加入的新增例外群組和 except*。

• PUSH_EXC_INFO 被用於例外處理函式。

• RESUME，為無操作 (no-po)，用於內部追查、除錯和最佳化檢查。

被取代的操作碼 (opcode)¶

所有跳位操作碼 (jump opcode) 現在都是相對的，包括現有的JUMP_IF_TRUE_OR_POP 和JUMP_IF_FALSE_OR_POP。該引數現在是目前指示 (instruction) 的偏移量而不是絕對位置。

有更動/被移除的 opcode¶

• 更改了MATCH_CLASS 和MATCH_KEYS ，不再推送一個額外的布林值來表示成功/失敗。取而代之的是會在失敗時推送None，而非一個包含提取值的元組。

• 更改了運作於例外的操作碼以反映它們現在在堆疊中的表示為一項而不是三項（請參閱gh-89874）。

• 刪除COPY_DICT_WITHOUT_KEYS、GEN_START、POP_BLOCK、SETUP_FINALLY 和YIELD_FROM。

語言/內建¶

• 鏈接classmethod 描述器（在bpo-19072 中引入）現已棄用。它不能再用於包裝其他描述器，例如property。此功能的核心設計存在缺陷，並導致了許多下游問題。要「傳遞通過 (pass-through)」classmethod，請考慮使用 Python 3.10 中添加的__wrapped__ 屬性。（由 Raymond Hettinger 在gh-89519 中貢獻。）

• 值大於0o377（十進位為 255）的字串和位元組文本值 (bytes literal) 中的八進位跳脫 (octal escape) 現在會產生DeprecationWarning。在未來的 Python 版本中，他們將引發一個SyntaxWarning 並最終引發一個SyntaxError。（由 Serhiy Storchaka 在gh-81548 中貢獻。）

• int() 到__trunc__() 的授權 (delegation) 現已棄用。當type(a) 有實作__trunc__() 但沒有__int__() 或__index__()，呼叫int(a) 現在會引發一個DeprecationWarning。（由 Zackery Spytz 在bpo-44977 中貢獻。）

模組¶

• PEP 594 引領下列模組的棄用，並排訂於 Python 3.13 移除：

  aifc	chunk	msilib	pipes	telnetlib
  audioop	crypt	nis	sndhdr	uu
  cgi	imghdr	nntplib	spwd	xdrlib
  cgitb	mailcap	ossaudiodev	sunau

  （由 Brett Cannon 和 Victor Stinner 分別於bpo-47061 與gh-68966 中所貢獻。）

• asynchat、asyncore 和smtpd 至少在 Python 3.6 以前就被棄用，它們的文件與棄用警告現在已被更新為會提示它們即將於 Python 3.12 中移除。（由 Hugo van Kemenade 於bpo-47022 中貢獻。）

• :mod:!lib2to3` 套件和2to3 工具現已棄用，可能無法剖析 Python 3.10 或更新版本。有關詳細資訊請參閱PEP 617，它引入了新的 PEG 剖析器。（由 Victor Stinner 在bpo-40360 中貢獻。）

• 未被記錄於文件中的sre_compile、sre_constants 和sre_parse 模組現在已被棄用。（由 Serhiy Storchaka 在bpo-47152 中貢獻。）

標準函式庫¶

• 以下configparser 相關項目已在 Python 3.2 中棄用，它們的棄用警告現在會提示它們即將於 Python 3.12 中移除：

  • configparser.SafeConfigParser 類別

  • configparser.ParsingError.filename 屬性

  • configparser.RawConfigParser.readfp() 方法

  （由 Hugo van Kemenade 於bpo-45173 中所貢獻。）

• configparser.LegacyInterpolation 自 Python 3.2 起已在文件字串中棄用，並且未在configparser 文件中列出。它現在會發出一個DeprecationWarning 並將在 Python 3.13 中刪除。請改用configparser.BasicInterpolation 或configparser.ExtendedInterpolation。（由 Hugo van Kemenade 在bpo-46607 中貢獻。）

• 舊的importlib.resources 函式集因為不支援定位套件子目錄中的資源而被棄用、並將在未來的 Python 版本中刪除，取而代之的是在 Python 3.9 中添加的替代方案：

  • importlib.resources.contents()

  • importlib.resources.is_resource()

  • importlib.resources.open_binary()

  • importlib.resources.open_text()

  • importlib.resources.read_binary()

  • importlib.resources.read_text()

  • importlib.resources.path()

• locale.getdefaultlocale() 函式已被棄用且將於 Python 3.15 中移除。請改用locale.setlocale()、locale.getpreferredencoding(False) 和locale.getlocale()。（Victor Stinner 於gh-90817 中所貢獻。）

• locale.resetlocale() 函式已棄用並將於 Python 3.13 中移除，請改用locale.setlocale(locale.LC_ALL,"")。（由 Victor Stinner 於gh-90817 中所貢獻。）

• 現在將對規則運算式中的數值群組參照 (numerical group references) 和群組名稱套用更嚴格的規則。現在只接受 ASCII 數字序列作為數值參照，並且bytes 模式 (pattern) 的群組名稱和替換字串中只能包含 ASCII 字母、數字和底線。目前，會針對違反這些規則的語法發出棄用警告。（由 Serhiy Storchaka 在gh-91760 中貢獻。）

• 在re 模組中，re.template() 函式和相應的re.TEMPLATE 和re.T 旗標被棄用，因為它們沒被記錄於文件中並且缺乏明顯的目的。它們將在 Python 3.13 中被刪除。（由 Serhiy Storchaka 和 Miro Hrončok 在gh-92728 中貢獻。）

• turtle.settiltangle() 自 Python 3.1 以來已被棄用；它現在會發出棄用警告，並將在 Python 3.13 中刪除。請改用turtle.tiltangle()（它之前被錯誤地標記為已棄用，其文件字串現在已更正）。（由 Hugo van Kemenade 在bpo-45837 中貢獻。）

• 僅用於支援 Python 2 和 Python 3 程式碼間相容性的typing.Text 現已棄用。目前未計劃刪除它，但鼓勵用戶盡可能使用str 代替。（由 Alex Waygood 在gh-92332 中貢獻。）

• 用於建構typing.TypedDict 型別的關鍵字引數語法現已棄用。將在 Python 3.13 中停止支援。（由 Jingchen Ye 在gh-90224 中貢獻。）

• webbrowser.MacOSX 已被棄用且將於 Python 3.13 中移除。它並沒有被測試過、沒紀錄於文件、也沒有被webbrowser 本身使用。（由 Donghee Na 於bpo-42255。）

• 回傳從TestCase 和IsolatedAsyncioTestCase 測試方法（預設的None 值除外）給定值的行為現已棄用。

• 棄用以下並沒有正式紀錄於文件中的unittest 函式，並預計於 Python 3.13 中移除：

  • unittest.findTestCases()

  • unittest.makeSuite()

  • unittest.getTestCaseNames()

  改用TestLoader 方法：

  • unittest.TestLoader.loadTestsFromModule()

  • unittest.TestLoader.loadTestsFromTestCase()

  • unittest.TestLoader.getTestCaseNames()

  （由 Erlend E. Aasland 於bpo-5846 中所貢獻。）

• unittest.TestProgram.usageExit() 被標記為已棄用，即將在 3.13 中移除（由 Carlos Damázio 在gh-67048 中貢獻。）

新增功能¶

• 新增PyType_GetName() 函式來取得型別的短名。（由 Hai Shi 於bpo-42035 中所貢獻。）

• 新增PyType_GetQualName() 函式來取得型別的合格名稱 (qualified name)。（由 Hai Shi 於bpo-42035 中所貢獻。）

• 在受限 C API (limited C API) 中新增PyThreadState_EnterTracing() 和PyThreadState_LeaveTracing() 函式來中止和繼續追蹤 (tracing) 和性能分析 (profiling)。（由 Victor Stinner 於bpo-43760 中貢獻。）

• 添加了Py_Version 常數，其值與PY_VERSION_HEX 相同。（由 Gabriele N. Tornetta 在bpo-43931 中貢獻。）

• Py_buffer 與 API 目前是受限 API 與穩定 ABI 中的一部分：

  • PyObject_CheckBuffer()

  • PyObject_GetBuffer()

  • PyBuffer_GetPointer()

  • PyBuffer_SizeFromFormat()

  • PyBuffer_ToContiguous()

  • PyBuffer_FromContiguous()

  • PyObject_CopyData()

  • PyBuffer_IsContiguous()

  • PyBuffer_FillContiguousStrides()

  • PyBuffer_FillInfo()

  • PyBuffer_Release()

  • PyMemoryView_FromBuffer()

  • bf_getbuffer 與bf_releasebuffer 型別插槽 (type slot)

  （由 Christian Heimes 於bpo-45459 中所貢獻。）

• 新增PyType_GetModuleByDef() 函式，它將被用於取得定義一個方法的模組，以免這項資訊無法直接被取得（透過PyCMethod）。（由 Petr Viktorin 於bpo-46613 中所貢獻。）

• 新增函式以打包 (pack) 和取出 (unpack) C double（序列化和反序列化）：PyFloat_Pack2()、PyFloat_Pack4()、PyFloat_Pack8()、PyFloat_Unpack2() ,PyFloat_Unpack4() 和PyFloat_Unpack8()。（由 Victor Stinner 在bpo-46906 中貢獻。）

• 新增取得幀物件屬性的函式：PyFrame_GetBuiltins()、PyFrame_GetGenerator()、PyFrame_GetGlobals()、PyFrame_GetLasti()。

• 添加了兩個新函式來獲得和設置仍在作用的例外實例：PyErr_GetHandledException() 和PyErr_SetHandledException()。這些是PyErr_SetExcInfo() 和PyErr_GetExcInfo() 的替代品，它們與例外的遺留三元組表示法一起作用。（由 Irit Katriel 在bpo-46343 中貢獻。）

• 新增PyConfig.safe_path 成員。（由 Victor Stinner 於gh-57684 中所貢獻。）

移植至 Python 3.11¶

• 一些巨集已轉換為行內靜態函式以避免巨集陷阱 (macro pitfalls)。這種變化對用戶來說應該是透明的，因為替換函式會將它們的引數轉換為預期的型別，以避免由於靜態型別檢查而產生的編譯器警告。但是，當受限 C API 設置為 >=3.11 時，這些轉換不會完成，使用者需要將引數轉換為他們期望的型別。有關更多詳細資訊，請參閱PEP 670。（由 Victor Stinner 和 Erlend E. Aasland 在gh-89653 中貢獻。）

• PyErr_SetExcInfo() 不再使用type 和traceback 引數，直譯器現在從例外實例（value 引數）中獲得這些值。該函式仍會偷用這三個引數的參照。（由 Irit Katriel 在bpo-45711 中貢獻。）

• PyErr_GetExcInfo() 現在從例外實例的結果（value 欄位）中導出type 和traceback 欄位。（由 Irit Katriel 在bpo-45711 中貢獻。）

• _frozen 有一個新的is_package 欄位來表示凍結模組是否為一個套件。以前size 欄位中的負值是指標，現在只有非負值可用於size。（由 Kumar Aditya 在bpo-46608 中貢獻。）

• _PyFrameEvalFunction() 現在將_PyInterpreterFrame* 作為其第二個參數，而不是PyFrameObject*。有關如何使用此函式指標型別的更多詳細資訊，請參閱PEP 523。

• PyCode_New() 和PyCode_NewWithPosOnlyArgs() 現在採用額外的exception_table 引數。如果可能的話應該避免使用這些函式。要取得自定義程式碼物件，使用編譯器建立一個程式碼物件，然後使用replace 方法來得到修改後的版本。

• PyCodeObject 不再會有co_code、co_varnames、co_cellvars 和co_freevars 欄位。分別被改為透過 C API 的PyCode_GetCode()、PyCode_GetVarnames()、PyCode_GetCellvars() 和PyCode_GetFreevars() 來存取。（由 Brandt Bucher 在bpo-46841、Ken Jin 在gh-92154 與gh-94936 中貢獻。）

• 舊的回收筒巨集 (trashcan macro) (Py_TRASHCAN_SAFE_BEGIN/Py_TRASHCAN_SAFE_END) 現在已經被棄用，它們應被新的巨集Py_TRASHCAN_BEGIN 和Py_TRASHCAN_END 所取代。

  一個用到老舊巨集的 tp_dealloc 函式，像是：

  staticvoidmytype_dealloc(mytype*p){PyObject_GC_UnTrack(p);Py_TRASHCAN_SAFE_BEGIN(p);...Py_TRASHCAN_SAFE_END}

  應該要搬遷到新的巨集，如下所示：

  staticvoidmytype_dealloc(mytype*p){PyObject_GC_UnTrack(p);Py_TRASHCAN_BEGIN(p,mytype_dealloc)...Py_TRASHCAN_END}

  請注意Py_TRASHCAN_BEGIN 有第二個引數，它應該是它所在的釋放函式 (deallocation function)。

  為支援舊版 Python 在同一份程式碼中，你可以定義以下巨集並在程式碼中使用它們（要歸功於mypy 程式碼，這些是從那邊複製過來的）：

  #if PY_VERSION_HEX >= 0x03080000#  define CPy_TRASHCAN_BEGIN(op, dealloc) Py_TRASHCAN_BEGIN(op, dealloc)#  define CPy_TRASHCAN_END(op) Py_TRASHCAN_END#else#  define CPy_TRASHCAN_BEGIN(op, dealloc) Py_TRASHCAN_SAFE_BEGIN(op)#  define CPy_TRASHCAN_END(op) Py_TRASHCAN_SAFE_END(op)#endif

• 如果一個型別是以Py_TPFLAGS_HAVE_GC 旗標來定義，但卻沒有遍歷函式 (traverse function) (PyTypeObject.tp_traverse)，那PyType_Ready() 函式現在會引發一個錯誤。（由 Victor Stinner 於bpo-44263 中貢獻。）

• 帶有Py_TPFLAGS_IMMUTABLETYPE 旗標的堆積型別現在可以繼承PEP 590 向量呼叫協定 (vectorcall protocol)。以前這僅適用於static types。（由 Erlend E. Aasland 在bpo-43908 中貢獻）。

• 由於Py_TYPE() 更改為行內靜態函式 (inline static function)，因此Py_TYPE(obj)=new_type 必須替換為Py_SET_TYPE(obj,new_type)：參見Py_SET_TYPE() 函式（自 Python 3.9 起可用）。為了向後相容，可以使用這個巨集：

  #if PY_VERSION_HEX < 0x030900A4 && !defined(Py_SET_TYPE)staticinlinevoid_Py_SET_TYPE(PyObject*ob,PyTypeObject*type){ob->ob_type=type;}#define Py_SET_TYPE(ob, type) _Py_SET_TYPE((PyObject*)(ob), type)#endif

  （由 Victor Stinner 於bpo-39573 中所貢獻。）

• 由於Py_SIZE() 更改為行內靜態函式，因此Py_SIZE(obj)=new_size 必須替換為Py_SET_SIZE(obj,new_size)：參見Py_SET_SIZE() 函式（自 Python 3.9 起可用）。為了向後相容，可以使用這個巨集：

  #if PY_VERSION_HEX < 0x030900A4 && !defined(Py_SET_SIZE)staticinlinevoid_Py_SET_SIZE(PyVarObject*ob,Py_ssize_tsize){ob->ob_size=size;}#define Py_SET_SIZE(ob, size) _Py_SET_SIZE((PyVarObject*)(ob), size)#endif

  （由 Victor Stinner 於bpo-39573 中所貢獻。）

• 當Py_LIMITED_API 巨集被設定為0x030b0000（Python 3.11）或以上，<Python.h> 不再會包含標頭檔<stdlib.h>、<stdio.h>、<errno.h> 和<string.h>。C 擴充程式應該要清楚的在#include<Python.h> 之後引入標頭檔案。（由 Victor Stinner 於bpo-45434 中貢獻。）

• 非受限 API (non-limited API) 檔案cellobject.h、classobject.h、code.h、context.h、funcobject.h、genobject.h 和longintrepr.h 已移至Include/cpython 目錄。此外，eval.h 標頭檔已被刪除。不能直接引入這些文件，因為它們已被包含在Python.h 中：引入檔案。如果它們已被直接引入，請考慮改為引入Python.h。 （由 Victor Stinner 在bpo-35134 中貢獻。）

• PyUnicode_CHECK_INTERNED() 巨集已從受限 C API 中移出，它從來沒辦法被使用，因為它使用了受限 C API 不提供的內部結構。（由 Victor Stinner 於bpo-46007 中所貢獻。）

• 以下用於幀 (frame) 的函式與型別現在可直接透過#include<Python.h> 來使用，不必再加上#include<frameobject.h>：

  • PyFrame_Check()

  • PyFrame_GetBack()

  • PyFrame_GetBuiltins()

  • PyFrame_GetGenerator()

  • PyFrame_GetGlobals()

  • PyFrame_GetLasti()

  • PyFrame_GetLocals()

  • PyFrame_Type

  （由 Victor Stinner 於gh-93937 中所貢獻。）

• PyFrameObject 結構成員已經從公開的 C API 中移除。

  雖然文件指出PyFrameObject 欄位隨時可能發生變化，但它們已經穩定了很長時間，並被用於幾個流行的擴充套件中。

  Python 3.11 中，幀的結構被重新編制來為性能做最佳化，有些作為舊版實作細節的欄位被整個移除。

  PyFrameObject 欄位：

  • f_back：使用PyFrame_GetBack()。

  • f_blockstack：已移除。

  • f_builtins：使用PyFrame_GetBuiltins()。

  • f_code：使用PyFrame_GetCode()。

  • f_gen：使用PyFrame_GetGenerator()。

  • f_globals：使用PyFrame_GetGlobals()。

  • f_iblock：已移除。

  • f_lasti：使用PyFrame_GetLasti()。程式碼中f_lasti 有與PyCode_Addr2Line() 同時使用的部分應該改用PyFrame_GetLineNumber()；它可能會更快。

  • f_lineno：使用PyFrame_GetLineNumber()

  • f_locals：使用PyFrame_GetLocals()。

  • f_stackdepth：已移除。

  • f_state：無公開 API（重新命名為f_frame.f_state）。

  • f_trace：無公開 API。

  • f_trace_lines：使用PyObject_GetAttrString((PyObject*)frame,"f_trace_lines")。

  • f_trace_opcodes：使用PyObject_GetAttrString((PyObject*)frame,"f_trace_opcodes")。

  • f_localsplus：無公開 API（重新命名為f_frame.localsplus）。

  • f_valuestack：已移除。

  Python 幀物件的建立現為惰性的 (lazily)，一個副作用是f_back 成員不能被直接存取，因為其職的計算也是惰性的，要改呼叫PyFrame_GetBack()。

  直接存取f_locals 的除錯器必須改為呼叫PyFrame_GetLocals()。他們不再需要呼叫PyFrame_FastToLocalsWithError() 或PyFrame_LocalsToFast()，事實上他們不應該呼叫這些函式。框架的必要更新現在由虛擬機管理。

  PyFrame_GetCode() 在 Python 3.8 以前的程式定義：

  #if PY_VERSION_HEX < 0x030900B1staticinlinePyCodeObject*PyFrame_GetCode(PyFrameObject*frame){Py_INCREF(frame->f_code);returnframe->f_code;}#endif

  PyFrame_GetBack() 在 Python 3.8 以前的程式定義：

  #if PY_VERSION_HEX < 0x030900B1staticinlinePyFrameObject*PyFrame_GetBack(PyFrameObject*frame){Py_XINCREF(frame->f_back);returnframe->f_back;}#endif

  或是使用pythoncap_compat 計畫來在舊版 Python 函式中取得這兩個函式。

• PyThreadState 結構成員的改動：

  • frame：已移除，改用PyThreadState_GetFrame()（bpo-40429 於 Python 3.9 新增的函式）。警告：會回傳strong reference 的函式必須呼叫Py_XDECREF()。

  • tracing：已變更，改用PyThreadState_EnterTracing() 和PyThreadState_LeaveTracing()（bpo-43760 於 Python 3.11 中新增的函式）。

  • recursion_depth：已移除，請改用(tstate->recursion_limit-tstate->recursion_remaining)。

  • stackcheck_counter：已移除。

  PyThreadState_GetFrame() 在 Python 3.8 以前的程式定義：

  #if PY_VERSION_HEX < 0x030900B1staticinlinePyFrameObject*PyThreadState_GetFrame(PyThreadState*tstate){Py_XINCREF(tstate->frame);returntstate->frame;}#endif

  PyThreadState_EnterTracing() 與PyThreadState_LeaveTracing() 在 Python 3.10 以前的程式定義：

  #if PY_VERSION_HEX < 0x030B00A2staticinlinevoidPyThreadState_EnterTracing(PyThreadState*tstate){tstate->tracing++;#if PY_VERSION_HEX >= 0x030A00A1tstate->cframe->use_tracing=0;#elsetstate->use_tracing=0;#endif}staticinlinevoidPyThreadState_LeaveTracing(PyThreadState*tstate){intuse_tracing=(tstate->c_tracefunc!=NULL||tstate->c_profilefunc!=NULL);tstate->tracing--;#if PY_VERSION_HEX >= 0x030A00A1tstate->cframe->use_tracing=use_tracing;#elsetstate->use_tracing=use_tracing;#endif}#endif

  或是使用pythoncap-compat 專案來在舊版 Python 函式中取得它們。

• 鼓勵發布者們使用最佳化過的 Blake2 函式庫libb2 來建置 Python。

• 初始化中若是要用PyConfig.module_search_paths 來初始化sys.path，則現在PyConfig.module_search_paths_set 必須被設為 1。否則，初始化會重新計算路徑並取代所有被加到module_search_paths 的值。

• PyConfig_Read() 不再計算初始搜尋路徑，並且不會將任何值填充到PyConfig.module_search_paths 中。若要計算預設路徑然後修改它們，完成初始化並使用PySys_GetObject() 以取得sys.path 作為 Python 列表物件並直接修改它。

已棄用¶

• 棄用以下用來配置 Python 初始化的函式：

  • PySys_AddWarnOptionUnicode()

  • PySys_AddWarnOption()

  • PySys_AddXOption()

  • PySys_HasWarnOptions()

  • PySys_SetArgvEx()

  • PySys_SetArgv()

  • PySys_SetPath()

  • Py_SetPath()

  • Py_SetProgramName()

  • Py_SetPythonHome()

  • Py_SetStandardStreamEncoding()

  • _Py_SetProgramFullPath()

  請改用Python 初始化配置中新的PyConfig API。（由 Victor Stinner 於gh-88279 中所貢獻。）

• 棄用PyBytesObject 中的ob_shash 成員。請改用PyObject_Hash()。（由 Inada Naoki 於bpo-46864 中所貢獻。）

Python 3.12 中待決議的移除項目¶

以下 C API 已於先前 Python 發布版本中棄用，並將於 Python 3.12 中移除。

• PyUnicode_AS_DATA()

• PyUnicode_AS_UNICODE()

• PyUnicode_AsUnicodeAndSize()

• PyUnicode_AsUnicode()

• PyUnicode_FromUnicode()

• PyUnicode_GET_DATA_SIZE()

• PyUnicode_GET_SIZE()

• PyUnicode_GetSize()

• PyUnicode_IS_COMPACT()

• PyUnicode_IS_READY()

• PyUnicode_READY()

• PyUnicode_WSTR_LENGTH()

• _PyUnicode_AsUnicode()

• PyUnicode_WCHAR_KIND

• PyUnicodeObject

• PyUnicode_InternImmortal()

已移除¶

• PyFrame_BlockSetup() andPyFrame_BlockPop() have beenremoved.(Contributed by Mark Shannon inbpo-40222.)

• 移除以下使用到errno 變數的數學巨集：

  • Py_ADJUST_ERANGE1()

  • Py_ADJUST_ERANGE2()

  • Py_OVERFLOWED()

  • Py_SET_ERANGE_IF_OVERFLOW()

  • Py_SET_ERRNO_ON_MATH_ERROR()

  （由 Victor Stinner 於bpo-45412 中所貢獻。）

• 移除在 Python 3.3 中棄用的Py_UNICODE_COPY() 和Py_UNICODE_FILL()。請改用PyUnicode_CopyCharacters() 或memcpy()（wchar_t* 字串）和PyUnicode_Fill() 函式。（由 Victor Stinner 於bpo-41123 中所貢獻。）

• 移除pystrhex.h 標頭檔案。它只有包含私有函式。C 的擴充應該只要引入主要的<Python.h> 標頭檔案。（由 Victor Stinner 於bpo-45434 中所貢獻。）

• 移除Py_FORCE_DOUBLE() 巨集。它先前被用於Py_IS_INFINITY() 巨集。（由 Victor Stinner 於bpo-45440 中所貢獻。）

• 當Py_LIMITED_API 有被定義時，以下項目將無法被取得：

  • PyMarshal_WriteLongToFile()

  • PyMarshal_WriteObjectToFile()

  • PyMarshal_ReadObjectFromString()

  • PyMarshal_WriteObjectToString()

  • Py_MARSHAL_VERSION 巨集

  These are not part of thelimited API.

  （由 Victor Stinner 於bpo-45474 中所貢獻。）

• 將PyWeakref_GET_OBJECT() 排除於受限 C API 之外，它因為PyWeakReference 結構在受限 C API 中過於晦澀而從未運作。（由 Victor Stinner 於bpo-35134 中所貢獻。）

• 移除PyHeapType_GET_MEMBERS() 巨集，它是不小心才被放到公開的 C API 中，應該只能被 Python 內部所使用。請改用PyTypeObject.tp_members。（由 Victor Stinner 於bpo-40170 中所貢獻。）

• 移除HAVE_PY_SET_53BIT_PRECISION 巨集（移動至內部 C API）。（由 Victor Stinner 於bpo-45412 中所貢獻。）

• 移除Py_UNICODE 編碼器 API，它們自從 Python 3.3 就被棄用，非常少用且和推薦的替代方案已無太大關聯。

  被移除的函式為：

  • PyUnicode_Encode()

  • PyUnicode_EncodeASCII()

  • PyUnicode_EncodeLatin1()

  • PyUnicode_EncodeUTF7()

  • PyUnicode_EncodeUTF8()

  • PyUnicode_EncodeUTF16()

  • PyUnicode_EncodeUTF32()

  • PyUnicode_EncodeUnicodeEscape()

  • PyUnicode_EncodeRawUnicodeEscape()

  • PyUnicode_EncodeCharmap()

  • PyUnicode_TranslateCharmap()

  • PyUnicode_EncodeDecimal()

  • PyUnicode_TransformDecimalToASCII()

  詳情請見PEP 624 與搬遷指南。（由 Inada Naoki 於bpo-44029 中所貢獻。）

tarfile¶

• The extraction methods intarfile, andshutil.unpack_archive(),have a new afilter argument that allows limiting tar features than may besurprising or dangerous, such as creating files outside the destinationdirectory.SeeExtraction filters for details.In Python 3.12, use without thefilter argument will show aDeprecationWarning.In Python 3.14, the default will switch to'data'.(Contributed by Petr Viktorin inPEP 706.)

OpenSSL¶

• Windows builds and macOS installers from python.org now use OpenSSL 3.0.