已棄用項目¶
Python 3.15 中待移除的項目¶
引入系統 (import system):
在模組上設定
__cached__而沒有設定__spec__.cached的做法已被棄用。在 Python 3.15 中,引入系統或標準函式庫將不再設定或考慮__cached__。(gh-97879)在模組上設定
__package__而沒有設定__spec__.parent的做法已被棄用。在 Python 3.15 中,引入系統或標準函式庫將不再設定或考慮__package__。(gh-97879)
-
自 Python 3.13 起,未記錄的
ctypes.SetPointerType()函式已被棄用。
-
The obsolete and rarely used
CGIHTTPRequestHandlerhas been deprecated since Python 3.13. No direct replacement exists. Anything is better than CGI to interface a web server with a request handler.自 Python 3.13 起,python -m http.server 命令列介面的
--cgi旗標已被棄用。
-
load_module()method:請改用exec_module()。
-
getdefaultlocale()已在 Python 3.11 中被棄用,原本計劃在 Python 3.13 中移除 (gh-90817),但被延後至 Python 3.15。請改用getlocale()、setlocale()和getencoding()。 (由 Hugo van Kemenade 於 gh-111187 貢獻。)
-
.PurePath.is_reserved()has been deprecated since Python 3.13. Useos.path.isreserved()to detect reserved paths on Windows.
-
platform.java_ver()has been deprecated since Python 3.13. This function is only useful for Jython support, has a confusing API, and is largely untested.
-
sysconfig.is_python_build()的 check_home 引數自 Python 3.12 起已被棄用。
-
RLock()在 Python 3.15 中將不接受任何引數。自 Python 3.14 起,傳遞任何引數的用法已被棄用,因為 Python 版本不允許任何引數,但 C 版本允許任意數量的位置或關鍵字引數,並忽略每個引數。
-
types.CodeType:自 3.10 起,存取co_lnotab已在 PEP 626 中被棄用,並計劃在 3.12 中移除,但只在 3.12 中於適當時發出DeprecationWarning。可能在 3.15 中移除。(由 Nikita Sobolev 於 gh-101866 貢獻。)
-
用於建立
NamedTuple類別的未以文件記錄之關鍵字引數語法 (Point = NamedTuple("Point", x=int, y=int)) 已自 Python 3.13 棄用。請改用基於類別的語法或函式語法 (functional syntax)。當使用
TypedDict的函式語法時,未傳遞值給 fields 參數 (TD = TypedDict("TD")) 或傳遞None(TD = TypedDict("TD", None)) 的做法自 Python 3.13 起已被棄用。請使用class TD(TypedDict): pass或TD = TypedDict("TD", {})來建立具有零個欄位的 TypedDict。The
typing.no_type_check_decorator()decorator function has been deprecated since Python 3.13. After eight years in thetypingmodule, it has yet to be supported by any major type checker.
sre_compile、sre_constants和sre_parse模組。wave:The
getmark(),setmark()andgetmarkers()methods of theWave_readandWave_writeclasses have been deprecated since Python 3.13.
-
zipimport.zipimporter.load_module()has been deprecated since Python 3.10. Useexec_module()instead. (gh-125746.)
Python 3.16 中待移除的項目¶
引入系統 (import system):
在模組上設定
__loader__而沒有設定__spec__.loader的做法將於 Python 3.16 被棄用。在 Python 3.16 中,引入系統或標準函式庫將不再設定或考慮__loader__。
-
自 Python 3.3 起,
'u'格式碼 (wchar_t) 在文件中已被棄用,自 Python 3.13 起在 runtime 已被棄用。請使用'w'格式碼 (Py_UCS4) 來取代 Unicode 字元。
-
asyncio.iscoroutinefunction()已被棄用並將在 Python 3.16 中移除;請改用inspect.iscoroutinefunction()。(由 Jiahao Li 和 Kumar Aditya 於 gh-122875 貢獻。)asyncio策略系統已被棄用並將在 Python 3.16 中移除。特別是以下類別和函式已被棄用:使用者應該使用
asyncio.run()或asyncio.Runner搭配 loop_factory 來使用所需的事件迴圈實作。例如在 Windows 上使用
asyncio.SelectorEventLoop:import asyncio async def main(): ... asyncio.run(main(), loop_factory=asyncio.SelectorEventLoop)
(由 Kumar Aditya 於 gh-127949 貢獻。)
-
自 Python 3.12 起,布林型別的位元反轉
~True或~False已被棄用,因為它會產生不預期且不直觀的結果(-2和-1)。使用not x代替布林值的邏輯否定。在極少數情況下,你需要對底層的整數進行位元反轉,請明確轉換為~int(x)(~int(x))。
-
自 Python 3.14 起,使用 function 或 sequence 關鍵字引數呼叫
functools.reduce()的 Python 實作已被棄用。
-
對具有 strm 引數的自訂日誌記錄處理函式的支援已被棄用,並計劃在 Python 3.16 中移除。請改用 stream 引數。(由 Mariusz Felisiak 於 gh-115032 貢獻。)
-
有效的副檔名以 '.' 開頭或對
mimetypes.MimeTypes.add_type()為空字串。未加點的副檔名已被棄用,並將在 Python 3.16 中引發ValueError。(由 Hugo van Kemenade 於 gh-75223 貢獻。)
-
自 Python 3.14 起,
ExecError例外已被棄用。自 Python 3.4 以來,它尚未被shutil中的任何函式使用,現在是RuntimeError的別名。
-
自 Python 3.14 起,
Class.get_methods方法已被棄用。
sys:自 Python 3.13 起,
_enablelegacywindowsfsencoding()函式已被棄用。請改用PYTHONLEGACYWINDOWSFSENCODING環境變數。
-
自 Python 3.14 起,
sysconfig.expand_makefile_vars()函式已被棄用。請改用sysconfig.get_paths()的vars引數。
-
自 Python 3.13 起,未以文件記錄和未被使用的
TarFile.tarfile屬性已被棄用。
Python 3.17 中待移除的項目¶
-
collections.abc.ByteString預計在 Python 3.17 中移除。使用
isinstance(obj, collections.abc.Buffer)來測試obj是否在 runtime 實作了緩衝區協定。在型別註解的使用中,請用Buffer或明確指定你的程式碼所支援型別的聯集(例如bytes | bytearray | memoryview)。ByteString最初被設計為一個抽象類別,以作為bytes和bytearray的超型別 (supertype)。然而由於 ABC 從未擁有任何方法,知道一個物件是ByteString的實例從未真正告訴你任何關於該物件的有用資訊。其他常見的緩衝區型別如memoryview也從未被理解為ByteString的子型別(無論是在 runtime 還是由靜態型別檢查器)。
-
在 Python 3.14 之前,舊式聯集是使用私有類別
typing._UnionGenericAlias實作的。這個類別不再被需要,但為了向後相容性而保留,並計劃將在 Python 3.17 中移除。使用者應該改用文件中記錄的內省輔助函式,例如typing.get_origin()和typing.get_args(),或者依賴私有實作細節。typing.ByteString自 Python 3.9 起已被棄用,預計在 Python 3.17 中移除。使用
isinstance(obj, collections.abc.Buffer)來測試obj是否在 runtime 實作了緩衝區協定。在型別註解的使用中,請用Buffer或明確指定你的程式碼所支援型別的聯集(例如bytes | bytearray | memoryview)。ByteString最初被設計為一個抽象類別,以作為bytes和bytearray的超型別 (supertype)。然而由於 ABC 從未擁有任何方法,知道一個物件是ByteString的實例從未真正告訴你任何關於該物件的有用資訊。其他常見的緩衝區型別如memoryview也從未被理解為ByteString的子型別(無論是在 runtime 還是由靜態型別檢查器)。
Python 3.19 中待移除的項目¶
-
In hash function constructors such as
new()or the direct hash-named constructors such asmd5()andsha256(), their optional initial data parameter could also be passed a keyword argument nameddata=orstring=in varioushashlibimplementations.Support for the
stringkeyword argument name is now deprecated and slated for removal in Python 3.19.Before Python 3.13, the
stringkeyword parameter was not correctly supported depending on the backend implementation of hash functions. Prefer passing the initial data as a positional argument for maximum backwards compatibility.
Pending removal in Python 3.20¶
The
__version__attribute has been deprecated in these standard library modules and will be removed in Python 3.20. Usesys.version_infoinstead.ctypes.macholibdecimal(usedecimal.SPEC_VERSIONinstead)logging(__date__also deprecated)
(Contributed by Hugo van Kemenade and Stan Ulbrych in gh-76007.)
未來版本中的待移除項目¶
以下 API 將在未來被移除,雖然目前尚未安排移除日期。
-
巢狀引數群組和巢狀互斥群組已被棄用。
將未以文件記錄的關鍵字引數 prefix_chars 傳遞給
add_argument_group()的做法現在已被棄用。argparse.FileType型別轉換器已被棄用。
-
產生器:
throw(type, exc, tb)和athrow(type, exc, tb)簽名已被棄用:請改用throw(exc)和athrow(exc),為單引數簽名。目前 Python 接受數值字面值後面立即接關鍵字,例如
0in x、1or x、0if 1else 2。它讓運算式模糊且容易混淆,如[0x1for x in y](可以解釋為[0x1 for x in y]或[0x1f or x in y])。如果數值字面值後立即接and、else、for、if、in、is和or之一的關鍵字,則會引發語法警告。在未來版本中,它將被更改為語法錯誤。(gh-87999)__index__()和__int__()方法回傳非 int 型別的支援:這些方法將需要回傳int的嚴格子類別實例。將
int()委派給__trunc__()方法。在
complex()建構子中將複數作為 real 或 imag 引數傳遞現在已被棄用;它應該只作為單個位置引數傳遞。 (由 Serhiy Storchaka 於 gh-109218 貢獻。)
calendar:calendar.January和calendar.February常數已被棄用並被calendar.JANUARY和calendar.FEBRUARY取代。 (由 Prince Roshan 於 gh-103636 貢獻。)codecs:請改用open()而非codecs.open()。(gh-133038)-
utcnow():請改用datetime.datetime.now(tz=datetime.UTC)。utcfromtimestamp():請改用datetime.datetime.fromtimestamp(timestamp, tz=datetime.UTC)。
gettext:複數值必須是整數。-
cache_from_source()debug_override 參數已被棄用:請改用 optimization 參數。
-
EntryPoints元組介面。回傳值上的隱式
None。
mailbox:已棄用 StringIO 輸入和文本模式,請改用 BytesIO 和二進位模式。os:在多執行緒行程中呼叫os.register_at_fork()。pydoc.ErrorDuringImport:exc_info 參數的元組值已被棄用,請用例外實例。re:現在對正規表示式中的數值群組參照和群組名稱用了更嚴格的規則。現在只有 ASCII 數碼序列被接受作為數值參照。位元組模式和替換字串中的群組名稱現在只能包含 ASCII 字母、數碼和底線。(由 Serhiy Storchaka 於 gh-91760 貢獻。)shutil:rmtree()的 onerror 參數在 Python 3.12 中已被棄用;請改用 onexc 參數。ssl選項和協定:不帶協定引數的
ssl.SSLContext已被棄用。ssl.SSLContext:set_npn_protocols()和selected_npn_protocol()已被棄用:請改用 ALPN。ssl.OP_NO_SSL*選項ssl.OP_NO_TLS*選項ssl.PROTOCOL_SSLv3ssl.PROTOCOL_TLSssl.PROTOCOL_TLSv1ssl.PROTOCOL_TLSv1_1ssl.PROTOCOL_TLSv1_2ssl.TLSVersion.SSLv3ssl.TLSVersion.TLSv1ssl.TLSVersion.TLSv1_1
threading方法:threading.Condition.notifyAll():請用notify_all()。threading.Event.isSet():請用is_set()。threading.Thread.isDaemon()、threading.Thread.setDaemon():請用threading.Thread.daemon屬性。threading.Thread.getName()、threading.Thread.setName():請用threading.Thread.name屬性。threading.currentThread():請用threading.current_thread()。threading.activeCount():請用threading.active_count()。
內部類別
typing._UnionGenericAlias不再用於實作typing.Union。為了保持與此私有類別使用者的相容性,直到至少 Python 3.17 都將提供一個相容性 shim。(由 Jelle Zijlstra 於 gh-105499 貢獻。)unittest.IsolatedAsyncioTestCase:從測試案例中回傳非None的值已被棄用。urllib.parse已棄用函式:請改用urlparse()。splitattr()splithost()splitnport()splitpasswd()splitport()splitquery()splittag()splittype()splituser()splitvalue()to_bytes()
wsgiref:SimpleHandler.stdout.write()不應該進行部分寫入。xml.etree.ElementTree:已棄用對Element的真值測試。在未來版本中,它將始終回傳True。請改用明確的len(elem)或elem is not None測試。sys._clear_type_cache()已被棄用:請改用sys._clear_internal_caches()。
C API 的棄用項目¶
Python 3.15 中待移除的項目¶
The
PyImport_ImportModuleNoBlock(): UsePyImport_ImportModule()instead.PyWeakref_GetObject()andPyWeakref_GET_OBJECT(): UsePyWeakref_GetRef()instead. The pythoncapi-compat project can be used to getPyWeakref_GetRef()on Python 3.12 and older.Py_UNICODE型別與Py_UNICODE_WIDE巨集:請改用wchar_t。PyUnicode_AsDecodedObject():請改用PyCodec_Decode()。PyUnicode_AsDecodedUnicode():請改用PyCodec_Decode();請注意某些編解碼器(例如 "base64")可能會回傳非str的型別,例如bytes。PyUnicode_AsEncodedObject():請改用PyCodec_Encode()。PyUnicode_AsEncodedUnicode():請改用PyCodec_Encode();請注意某些編解碼器(例如 "base64")可能會回傳非bytes的型別,例如str。Python 初始化函式,自 Python 3.13 起已被棄用:
Py_GetPath(): UsePyConfig_Get("module_search_paths")(sys.path) instead.Py_GetPrefix(): UsePyConfig_Get("base_prefix")(sys.base_prefix) instead. UsePyConfig_Get("prefix")(sys.prefix) if virtual environments need to be handled.Py_GetExecPrefix(): UsePyConfig_Get("base_exec_prefix")(sys.base_exec_prefix) instead. UsePyConfig_Get("exec_prefix")(sys.exec_prefix) if virtual environments need to be handled.Py_GetProgramFullPath(): UsePyConfig_Get("executable")(sys.executable) instead.Py_GetProgramName(): UsePyConfig_Get("executable")(sys.executable) instead.Py_GetPythonHome(): UsePyConfig_Get("home")or thePYTHONHOMEenvironment variable instead.
pythoncapi-compat 專案 可以用來為 Python 3.13 和更早版本取得
PyConfig_Get()。用於配置 Python 初始化的函式,自 Python 3.11 起已被棄用:
PySys_SetArgvEx():請改用PyConfig.argv。PySys_SetArgv():請改用PyConfig.argv。Py_SetProgramName():請改用PyConfig.program_name。Py_SetPythonHome():請改用PyConfig.home。PySys_ResetWarnOptions(): Clearsys.warnoptionsandwarnings.filtersinstead.
應改用帶有
PyConfig的Py_InitializeFromConfig()API。全域配置變數:
Py_DebugFlag:請改用PyConfig.parser_debug或PyConfig_Get("parser_debug")。Py_VerboseFlag:請改用PyConfig.verbose或PyConfig_Get("verbose")。Py_InteractiveFlag:請改用PyConfig.interactive或PyConfig_Get("interactive")。Py_InspectFlag:請改用PyConfig.inspect或PyConfig_Get("inspect")。Py_OptimizeFlag:請改用PyConfig.optimization_level或PyConfig_Get("optimization_level")。Py_NoSiteFlag:請改用PyConfig.site_import或PyConfig_Get("site_import")。Py_BytesWarningFlag:請改用PyConfig.bytes_warning或PyConfig_Get("bytes_warning")。Py_FrozenFlag:請改用PyConfig.pathconfig_warnings或PyConfig_Get("pathconfig_warnings")。Py_IgnoreEnvironmentFlag:請改用PyConfig.use_environment或PyConfig_Get("use_environment")。Py_DontWriteBytecodeFlag:請改用PyConfig.write_bytecode或PyConfig_Get("write_bytecode")。Py_NoUserSiteDirectory:請改用PyConfig.user_site_directory或PyConfig_Get("user_site_directory")。Py_UnbufferedStdioFlag:請改用PyConfig.buffered_stdio或PyConfig_Get("buffered_stdio")。Py_HashRandomizationFlag:請改用PyConfig.use_hash_seed和PyConfig.hash_seed或PyConfig_Get("hash_seed")。Py_IsolatedFlag:請改用PyConfig.isolated或PyConfig_Get("isolated")。Py_LegacyWindowsFSEncodingFlag:請改用PyPreConfig.legacy_windows_fs_encoding或PyConfig_Get("legacy_windows_fs_encoding")。Py_LegacyWindowsStdioFlag:請改用PyConfig.legacy_windows_stdio或PyConfig_Get("legacy_windows_stdio")。Py_FileSystemDefaultEncoding、Py_HasFileSystemDefaultEncoding:請改用PyConfig.filesystem_encoding或PyConfig_Get("filesystem_encoding")。Py_FileSystemDefaultEncodeErrors:請改用PyConfig.filesystem_errors或PyConfig_Get("filesystem_errors")。Py_UTF8Mode:請改用PyPreConfig.utf8_mode或PyConfig_Get("utf8_mode")。(請參閱Py_PreInitialize())
應改用帶有
PyConfig的Py_InitializeFromConfig()API 來設定這些選項。或者也可以使用PyConfig_Get()在執行時取得這些選項。
Python 3.18 中待移除的項目¶
以下私有函式已被棄用,並計劃在 Python 3.18 中移除:
_PyBytes_Join():請改用PyBytes_Join()。_PyDict_GetItemStringWithError():請改用PyDict_GetItemStringRef()。_PyDict_Pop():請改用PyDict_Pop()。_PyLong_Sign():請改用PyLong_GetSign()。_PyLong_FromDigits()和_PyLong_New():請改用PyLongWriter_Create()。_PyThreadState_UncheckedGet():請改用PyThreadState_GetUnchecked()。_PyUnicode_AsString():請改用PyUnicode_AsUTF8()。_PyUnicodeWriter_Init():將_PyUnicodeWriter_Init(&writer)替換為writer = PyUnicodeWriter_Create(0)。_PyUnicodeWriter_Finish():將_PyUnicodeWriter_Finish(&writer)替換為PyUnicodeWriter_Finish(writer)。_PyUnicodeWriter_Dealloc():將_PyUnicodeWriter_Dealloc(&writer)替換為PyUnicodeWriter_Discard(writer)。_PyUnicodeWriter_WriteChar():將_PyUnicodeWriter_WriteChar(&writer, ch)替換為PyUnicodeWriter_WriteChar(writer, ch)。_PyUnicodeWriter_WriteStr():將_PyUnicodeWriter_WriteStr(&writer, str)替換為PyUnicodeWriter_WriteStr(writer, str)。_PyUnicodeWriter_WriteSubstring():將_PyUnicodeWriter_WriteSubstring(&writer, str, start, end)替換為PyUnicodeWriter_WriteSubstring(writer, str, start, end)。_PyUnicodeWriter_WriteASCIIString():將_PyUnicodeWriter_WriteASCIIString(&writer, str)替換為PyUnicodeWriter_WriteASCII(writer, str)。_PyUnicodeWriter_WriteLatin1String():將_PyUnicodeWriter_WriteLatin1String(&writer, str)替換為PyUnicodeWriter_WriteUTF8(writer, str)。_PyUnicodeWriter_Prepare():(無替代方案)。_PyUnicodeWriter_PrepareKind():(無替代方案)。_Py_HashPointer():請改用Py_HashPointer()。_Py_fopen_obj():請改用Py_fopen()。
可以使用 pythoncapi-compat project 來取得這些於 Python 3.13 及更早版本的新公開函式。(由 Victor Stinner 在 gh-128863 貢獻)
Pending removal in Python 3.20¶
The
cvalfield inPyComplexObject(gh-128813). UsePyComplex_AsCComplex()andPyComplex_FromCComplex()to convert a Python complex number to/from the CPy_complexrepresentation.
未來版本中的待移除項目¶
下列 API 已被棄用並將會被移除,不過目前尚未訂定移除日期。
Py_TPFLAGS_HAVE_FINALIZE:自 Python 3.8 起不再需要PySlice_GetIndicesEx():請改用PySlice_Unpack()和PySlice_AdjustIndices()。PyUnicode_READY():自 Python 3.12 起不再需要PyErr_Display():請改用PyErr_DisplayException()。_PyErr_ChainExceptions():請改用_PyErr_ChainExceptions1。PyBytesObject.ob_shash成員:請改為呼叫PyObject_Hash()。執行緒局部儲存 (Thread Local Storage, TLS) API: