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

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

Traceback (most recent call last):
  File "distance.py", line 11, in <module>
    print(manhattan_distance(p1, p2))
          ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "distance.py", line 6, in manhattan_distance
    return abs(point_1.x - point_2.x) + abs(point_1.y - point_2.y)
                           ^^^^^^^^^
AttributeError: 'NoneType' object has no attribute 'x'

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

Traceback (most recent call last):
  File "query.py", line 37, in <module>
    magic_arithmetic('foo')
  File "query.py", line 18, in magic_arithmetic
    return add_counts(x) / 25
           ^^^^^^^^^^^^^
  File "query.py", line 24, in add_counts
    return 25 + query_user(user1) + query_user(user2)
                ^^^^^^^^^^^^^^^^^
  File "query.py", line 32, in query_user
    return 1 + query_count(db, response['a']['b']['c']['user'], retry=True)
                               ~~~~~~~~~~~~~~~~~~^^^^^
TypeError: 'NoneType' object is not subscriptable

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

Traceback (most recent call last):
  File "calculation.py", line 54, in <module>
    result = (x / y / z) * (a / b / c)
              ~~~~~~^~~
ZeroDivisionError: division by zero

此外，強化回溯特性所使用的資訊可以透過一般的 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 所撰寫）

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

Python 3.11 所包含的 Python 安裝管理員 複製品有了顯著的改善。它現在支援 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：

class Movie(TypedDict):
   title: str
   year: NotRequired[int]

m1: Movie = {"title": "Black Panther", "year": 2018}  # OK
m2: Movie = {"title": "Star Wars"}  # OK (year is not required)
m3: Movie = {"year": 2022}  # ERROR (missing required field title)

以下定義等同於：

class Movie(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__() 方法：

class MyLock:
    def __enter__(self) -> Self:
        self.lock()
        return self

    ...

class MyInt:
    @classmethod
    def fromhex(cls, s: str) -> Self:
        return cls(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) 可以被標註為：

def run_query(sql: LiteralString) -> ...:
    ...

def caller(
    arbitrary_string: str,
    query_string: LiteralString,
    table_name: LiteralString,
) -> None:
    run_query("SELECT * FROM students")       # ok
    run_query(query_string)                   # ok
    run_query("SELECT * FROM " + table_name)  # ok
    run_query(arbitrary_string)               # type checker error
    run_query(                                # type checker error
        f"SELECT * FROM students WHERE name = {arbitrary_string}"
    )

詳情請見 PEP 675。

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

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

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

舉例來說：

# create_model 裝飾器是由一個函式庫定義。
@typing.dataclass_transform()
def create_model(cls: Type[T]) -> Type[T]:
    cls.__init__ = ...
    cls.__eq__ = ...
    cls.__ne__ = ...
    return cls

# create_model 裝飾器現在可以被用來建立新的模型類別：
@create_model
class CustomerModel:
    id: int
    name: str

c = 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__ import annotations future 陳述式）最初計劃在 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 in gh-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() 裝飾器以確保被裝飾的物件會/不會被轉換成一個列舉成員。

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

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

• 強化 Flag 以支援使用 len()、疊代 (iteration) 和 in/not in 於其成員。例如，以下程式現在能夠作用了：len(AFlag(3)) == 2 and list(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) 引數的標註。

  >>> from functools import singledispatch
  >>> @singledispatch
  ... def fun(arg, verbose=False):
  ...     if verbose:
  ...         print("Let me just say,", end=" ")
  ...     print(arg)
  ...
  >>> @fun.register
  ... def _(arg: int | float, verbose=False):
  ...     if verbose:
  ...         print("Strength in numbers, eh?", end=" ")
  ...     print(arg)
  ...
  >>> from typing import Union
  >>> @fun.register
  ... def _(arg: Union[list, set], verbose=False):
  ...     if verbose:
  ...         print("Enumerate this:")
  ...     for i, elem in enumerate(arg):
  ...         print(i, elem)
  ...
  

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

gzip¶

• The gzip.compress() function is now faster when used with the mtime=0 argument as it delegates the compression entirely to a single zlib.compress() operation. There is one side effect of this change: The gzip file header contains an "OS" byte in its header. That was traditionally always set to a value of 255 representing "unknown" by the gzip module. Now, when using compress() with mtime=0, it may be set to a different value by the underlying zlib C library Python was linked against. (See gh-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 回呼現在使用無法被引發的例外。使用者現在可以註冊一個無法被引發的掛鈎處理程式 (unraisable hook handler) 來改善他們的除錯體驗。（由 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__ 屬性。（由 Jelle Zijlstra 於 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 虛擬環境時，venv sysconfig 安裝方案會被用於確定環境內的路徑。當 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)¶

有更動/被移除的 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 函式，像是：

  static void
  mytype_dealloc(mytype *p)
  {
      PyObject_GC_UnTrack(p);
      Py_TRASHCAN_SAFE_BEGIN(p);
      ...
      Py_TRASHCAN_SAFE_END(p)
  }
  

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

  static void
  mytype_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)
  static inline void _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)
  static inline void _Py_SET_SIZE(PyVarObject *ob, Py_ssize_t size)
  { 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 < 0x030900B1
  static inline PyCodeObject* PyFrame_GetCode(PyFrameObject *frame)
  {
      Py_INCREF(frame->f_code);
      return frame->f_code;
  }
  #endif
  

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

  #if PY_VERSION_HEX < 0x030900B1
  static inline PyFrameObject* PyFrame_GetBack(PyFrameObject *frame)
  {
      Py_XINCREF(frame->f_back);
      return frame->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 < 0x030900B1
  static inline PyFrameObject* PyThreadState_GetFrame(PyThreadState *tstate)
  {
      Py_XINCREF(tstate->frame);
      return tstate->frame;
  }
  #endif
  

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

  #if PY_VERSION_HEX < 0x030B00A2
  static inline void PyThreadState_EnterTracing(PyThreadState *tstate)
  {
      tstate->tracing++;
  #if PY_VERSION_HEX >= 0x030A00A1
      tstate->cframe->use_tracing = 0;
  #else
      tstate->use_tracing = 0;
  #endif
  }
  
  static inline void PyThreadState_LeaveTracing(PyThreadState *tstate)
  {
      int use_tracing = (tstate->c_tracefunc != NULL || tstate->c_profilefunc != NULL);
      tstate->tracing--;
  #if PY_VERSION_HEX >= 0x030A00A1
      tstate->cframe->use_tracing = use_tracing;
  #else
      tstate->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() and PyFrame_BlockPop() have been removed. (Contributed by Mark Shannon in bpo-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 the limited API.

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

• Exclude PyWeakref_GET_OBJECT() from the limited C API. It never worked since the PyWeakReference structure is opaque in the limited C API. (Contributed by Victor Stinner in 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 in tarfile, and shutil.unpack_archive(), have a new a filter argument that allows limiting tar features than may be surprising or dangerous, such as creating files outside the destination directory. See 解壓縮篩選器 for details. In Python 3.12, use without the filter argument will show a DeprecationWarning. In Python 3.14, the default will switch to 'data'. (Contributed by Petr Viktorin in PEP 706.)

OpenSSL¶

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