弃用

计划在 Python 3.14 中移除

• argparse：argparse.BooleanOptionalAction 的 type、choices 和 metavar 参数已弃用，将在 3.14 中移除。(由 Nikita Sobolev 在 gh-92248 中贡献。)

• ast：自 Python 3.8 以来，以下特性在文档中已被弃用，现在当它们被访问或使用时会发出 DeprecationWarning 运行时警告，并将在 Python 3.14 中移除

  • ast.Num

  • ast.Str

  • ast.Bytes

  • ast.NameConstant

  • ast.Ellipsis

  请改用 ast.Constant。(由 Serhiy Storchaka 在 gh-90953 中贡献。)

• asyncio:

  • 子进程监视器类 MultiLoopChildWatcher、FastChildWatcher、AbstractChildWatcher 和 SafeChildWatcher 已弃用，将在 Python 3.14 中移除。(由 Kumar Aditya 在 gh-94597 中贡献。)

  • asyncio.set_child_watcher()、asyncio.get_child_watcher()、asyncio.AbstractEventLoopPolicy.set_child_watcher() 和 asyncio.AbstractEventLoopPolicy.get_child_watcher() 已弃用，将在 Python 3.14 中移除。(由 Kumar Aditya 在 gh-94597 中贡献。)

  • 如果当前没有设置事件循环，且默认事件循环策略决定创建一个事件循环，则 get_event_loop() 默认事件循环策略方法现在会发出 DeprecationWarning。(由 Serhiy Storchaka 和 Guido van Rossum 在 gh-100160 中贡献。)

• collections.abc：已弃用 ByteString。请优先使用 Sequence 或 Buffer。 对于类型注解，请优先使用联合类型，例如 bytes | bytearray，或 collections.abc.Buffer。(由 Shantanu Jain 在 gh-91896 中贡献。)

• email：已弃用 email.utils.localtime() 中的 isdst 参数。(由 Alan Williams 在 gh-72346 中贡献。)

• importlib.abc 已弃用的类

  • importlib.abc.ResourceReader

  • importlib.abc.Traversable

  • importlib.abc.TraversableResources

  请改用 importlib.resources.abc 中的类

  • importlib.resources.abc.Traversable

  • importlib.resources.abc.TraversableResources

  (由 Jason R. Coombs 和 Hugo van Kemenade 在 gh-93963 中贡献。)

• itertools 对复制、深拷贝和 pickle 操作具有未记录、效率低下、历史错误且不一致的支持。为了显著减少代码量和维护负担，此功能将在 3.14 中移除。(由 Raymond Hettinger 在 gh-101588 中贡献。)

• multiprocessing：在 Linux、BSD 和其他非 macOS POSIX 平台上，默认启动方法将更改为更安全的方法，这些平台当前默认使用 'fork' (gh-84559)。添加关于此的运行时警告被认为具有破坏性，因为大多数代码不应该关心此事。当你的代码 _需要_ 'fork' 时，请使用 get_context() 或 set_start_method() API 来显式指定。 请参阅上下文和启动方法。

• pathlib：is_relative_to() 和 relative_to()：传递额外的参数已被弃用。

• pkgutil：find_loader() 和 get_loader() 现在会引发 DeprecationWarning；请改用 importlib.util.find_spec()。(由 Nikita Sobolev 在 gh-97850 中贡献。)

• pty:

  • master_open()：请使用 pty.openpty()。

  • slave_open()：请使用 pty.openpty()。

• sqlite3:

  • version 和 version_info。

  • 如果使用了命名占位符且 parameters 是序列而不是 dict，则execute() 和 executemany() 已被弃用。

• typing：自 Python 3.9 起已弃用的 ByteString，现在使用时会发出 DeprecationWarning 警告。

• urllib: urllib.parse.Quoter 已弃用：它本不应作为公共 API 使用。(由 Gregory P. Smith 在 gh-88168 中贡献。)

计划在 Python 3.15 中移除

• 导入系统

  • 在模块上设置 __cached__ 但未设置 __spec__.cached 已被弃用。在 Python 3.15 中，导入系统或标准库将不再设置或考虑 __cached__。( gh-97879 )

  • 在模块上设置 __package__ 但未设置 __spec__.parent 已被弃用。在 Python 3.15 中，导入系统或标准库将不再设置或考虑 __package__。( gh-97879 )

• ctypes:

  • 未文档化的 ctypes.SetPointerType() 函数自 Python 3.13 起已被弃用。

• http.server:

  • 过时且很少使用的 CGIHTTPRequestHandler 自 Python 3.13 起已被弃用。没有直接的替代品。任何方法都比 CGI 更好，可以将 Web 服务器与请求处理程序连接起来。

  • python -m http.server 命令行接口的 --cgi 标志自 Python 3.13 起已被弃用。

• locale:

  • getdefaultlocale() 函数自 Python 3.11 起已被弃用。它最初计划在 Python 3.13 中删除 ( gh-90817 )，但已推迟到 Python 3.15。请改用 getlocale()、setlocale() 和 getencoding()。(由 Hugo van Kemenade 在 gh-111187 中贡献。)

• pathlib:

  • PurePath.is_reserved() 自 Python 3.13 起已被弃用。请使用 os.path.isreserved() 检测 Windows 上保留的路径。

• platform:

  • java_ver() 自 Python 3.13 起已被弃用。此函数仅对 Jython 支持有用，具有令人困惑的 API，并且很大程度上未经测试。

• threading:

  • RLock() 在 Python 3.15 中将不接受任何参数。自 Python 3.14 起，传递任何参数都已被弃用，因为 Python 版本不允许任何参数，但 C 版本允许任意数量的位置或关键字参数，并忽略每个参数。

• types:

  • types.CodeType：访问 co_lnotab 在 PEP 626 中自 3.10 起被弃用，并计划在 3.12 中删除，但它仅在 3.12 中获得了适当的 DeprecationWarning。可能会在 3.15 中删除。(由 Nikita Sobolev 在 gh-101866 中贡献。)

• typing:

  • 用于创建 NamedTuple 类的未文档化的关键字参数语法 (例如 Point = NamedTuple("Point", x=int, y=int)) 自 Python 3.13 起已被弃用。请改用基于类的语法或函数式语法。

  • typing.no_type_check_decorator() 装饰器函数自 Python 3.13 起已被弃用。在 typing 模块中八年后，它尚未获得任何主要类型检查器的支持。

• wave:

  • getmark()、setmark() 和 getmarkers() 方法，这些方法属于 Wave_read 和 Wave_write 类，自 Python 3.13 起已被弃用。

计划在 Python 3.16 中移除

• 导入系统

  • 在模块上设置 __loader__ 但未设置 __spec__.loader 已被弃用。在 Python 3.16 中，导入系统或标准库将不再设置或考虑 __loader__。

• array:

  • 'u' 格式代码 (wchar_t) 自 Python 3.3 起在文档中被弃用，自 Python 3.13 起在运行时被弃用。请改用 'w' 格式代码 (Py_UCS4) 来表示 Unicode 字符。

• asyncio:

  • asyncio.iscoroutinefunction() 已弃用，将在 Python 3.16 中删除，请改用 inspect.iscoroutinefunction()。(由 Jiahao Li 和 Kumar Aditya 在 gh-122875 中贡献。)

• builtins:

  • 对布尔类型进行按位取反，即 ~True 或 ~False 自 Python 3.12 起已被弃用，因为它会产生令人惊讶且不直观的结果 (-2 和 -1)。请改用 not x 来表示布尔值的逻辑否定。在极少数需要底层整数的按位取反的情况下，请显式转换为 int ( ~int(x) )。

• shutil:

  • ExecError 异常自 Python 3.14 起已被弃用。自 Python 3.4 起，shutil 中的任何函数都未使用它，现在它是 RuntimeError 的别名。

• symtable:

  • Class.get_methods 方法自 Python 3.14 起已被弃用。

• sys:

  • _enablelegacywindowsfsencoding() 函数自 Python 3.13 起已被弃用。请改用 PYTHONLEGACYWINDOWSFSENCODING 环境变量。

• tarfile:

  • 未记录且未使用的 TarFile.tarfile 属性自 Python 3.13 起已被弃用。

未来版本中待移除

以下 API 将在未来被移除，尽管目前尚未确定移除的日期。

• argparse: 嵌套参数组和嵌套互斥组已被弃用。

• array 的 'u' 格式代码 (gh-57281)

• builtins:

  • bool(NotImplemented).

  • 生成器：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 的严格子类的实例。

  • 支持 __float__() 方法返回 float 的严格子类：这些方法将需要返回 float 的实例。

  • 支持 __complex__() 方法返回 complex 的严格子类：这些方法将需要返回 complex 的实例。

  • 将 int() 委托给 __trunc__() 方法。

  • 现在，将复数作为 complex() 构造函数中的 real 或 imag 参数传递已被弃用；它应该只作为单个位置参数传递。(由 Serhiy Storchaka 在 gh-109218 中贡献。)

• calendar: calendar.January 和 calendar.February 常量已被弃用，并由 calendar.JANUARY 和 calendar.FEBRUARY 替代。（由 Prince Roshan 在 gh-103636 中贡献。）

• codeobject.co_lnotab: 请改用 codeobject.co_lines() 方法。

• datetime:

  • utcnow(): 请使用 datetime.datetime.now(tz=datetime.UTC)。

  • utcfromtimestamp(): 请使用 datetime.datetime.fromtimestamp(timestamp, tz=datetime.UTC)。

• gettext: 复数的值必须是整数。

• importlib:

  • load_module() 方法：请改用 exec_module()。

  • cache_from_source() 的 debug_override 参数已被弃用：请改用 optimization 参数。

• importlib.metadata:

  • EntryPoints 元组接口。

  • 返回值的隐式 None。

• logging: warn() 方法自 Python 3.3 起已被弃用，请改用 warning()。

• mailbox: 使用 StringIO 输入和文本模式已被弃用，请改用 BytesIO 和二进制模式。

• os: 在多线程进程中调用 os.register_at_fork()。

• pydoc.ErrorDuringImport: exc_info 参数的元组值已被弃用，请使用异常实例。

• re: 现在对正则表达式中的数字组引用和组名应用更严格的规则。现在只接受 ASCII 数字序列作为数字引用。字节模式和替换字符串中的组名现在只能包含 ASCII 字母、数字和下划线。（由 Serhiy Storchaka 在 gh-91760 中贡献。）

• sre_compile、sre_constants 和 sre_parse 模块。

• 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_SSLv3

  • ssl.PROTOCOL_TLS

  • ssl.PROTOCOL_TLSv1

  • ssl.PROTOCOL_TLSv1_1

  • ssl.PROTOCOL_TLSv1_2

  • ssl.TLSVersion.SSLv3

  • ssl.TLSVersion.TLSv1

  • ssl.TLSVersion.TLSv1_1

• sysconfig.is_python_build() 的 check_home 参数已被弃用且被忽略。

• 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.Text (gh-92332)。

• unittest.IsolatedAsyncioTestCase：从测试用例返回值（非 None）已被弃用。

• urllib.parse 已弃用的函数：使用 urlparse() 代替

  • splitattr()

  • splithost()

  • splitnport()

  • splitpasswd()

  • splitport()

  • splitquery()

  • splittag()

  • splittype()

  • splituser()

  • splitvalue()

  • to_bytes()

• urllib.request：调用请求的 URLopener 和 FancyURLopener 风格已被弃用。请使用较新的 urlopen() 函数和方法。

• wsgiref：SimpleHandler.stdout.write() 不应执行部分写入。

• xml.etree.ElementTree：测试 Element 的真值已被弃用。在未来的版本中，它将始终返回 True。请优先使用显式的 len(elem) 或 elem is not None 测试。

• zipimport.zipimporter.load_module() 已被弃用：请改用 exec_module()。

C API 弃用

在 Python 3.14 中即将移除

• 扩展模块中 PyDictObject 的 ma_version_tag 字段（PEP 699；gh-101193）。

• 创建具有可变基类的 immutable types (gh-95388)。

• 用于配置 Python 初始化的函数，在 Python 3.11 中已弃用

  • PySys_SetArgvEx()：请改用设置 PyConfig.argv。

  • PySys_SetArgv()：请改用设置 PyConfig.argv。

  • Py_SetProgramName()：请改用设置 PyConfig.program_name。

  • Py_SetPythonHome()：请改用设置 PyConfig.home。

  应该使用 Py_InitializeFromConfig() API 和 PyConfig。

• 全局配置变量

  • Py_DebugFlag：请改用 PyConfig.parser_debug。

  • Py_VerboseFlag：请改用 PyConfig.verbose。

  • Py_QuietFlag：请改用 PyConfig.quiet。

  • Py_InteractiveFlag：请改用 PyConfig.interactive。

  • Py_InspectFlag：请改用 PyConfig.inspect。

  • Py_OptimizeFlag：请改用 PyConfig.optimization_level。

  • Py_NoSiteFlag：请改用 PyConfig.site_import。

  • Py_BytesWarningFlag：请改用 PyConfig.bytes_warning。

  • Py_FrozenFlag：请改用 PyConfig.pathconfig_warnings。

  • Py_IgnoreEnvironmentFlag：请改用 PyConfig.use_environment。

  • Py_DontWriteBytecodeFlag：请改用 PyConfig.write_bytecode。

  • Py_NoUserSiteDirectory：请改用 PyConfig.user_site_directory。

  • Py_UnbufferedStdioFlag：请改用 PyConfig.buffered_stdio。

  • Py_HashRandomizationFlag：请改用 PyConfig.use_hash_seed 和 PyConfig.hash_seed。

  • Py_IsolatedFlag：请改用 PyConfig.isolated。

  • Py_LegacyWindowsFSEncodingFlag：请改用 PyPreConfig.legacy_windows_fs_encoding。

  • Py_LegacyWindowsStdioFlag：请改用 PyConfig.legacy_windows_stdio。

  • Py_FileSystemDefaultEncoding：请改用 PyConfig.filesystem_encoding。

  • Py_HasFileSystemDefaultEncoding：请改用 PyConfig.filesystem_encoding。

  • Py_FileSystemDefaultEncodeErrors：请改用 PyConfig.filesystem_errors。

  • Py_UTF8Mode：请改用 PyPreConfig.utf8_mode。（参见 Py_PreInitialize()）

  应该使用 Py_InitializeFromConfig() API 和 PyConfig。

计划在 Python 3.15 中移除

• 捆绑的 libmpdecimal 副本。

• PyImport_ImportModuleNoBlock()：请改用 PyImport_ImportModule()。

• PyWeakref_GetObject() 和 PyWeakref_GET_OBJECT()：请改用 PyWeakref_GetRef()。

• Py_UNICODE 类型和 Py_UNICODE_WIDE 宏：请改用 wchar_t。

• Python 初始化函数

  • PySys_ResetWarnOptions()：请改为清除 sys.warnoptions 和 warnings.filters。

  • Py_GetExecPrefix()：请改为获取 sys.base_exec_prefix 和 sys.exec_prefix。

  • Py_GetPath()：请改为获取 sys.path。

  • Py_GetPrefix()：请改为获取 sys.base_prefix 和 sys.prefix。

  • Py_GetProgramFullPath()：请改为获取 sys.executable。

  • Py_GetProgramName()：请改为获取 sys.executable。

  • Py_GetPythonHome()：请改为获取 PyConfig.home 或者 PYTHONHOME 环境变量。

计划在未来版本中移除

以下 API 已弃用，将被移除，尽管目前尚未确定移除日期。

• Py_TPFLAGS_HAVE_FINALIZE：自 Python 3.8 起不再需要。

• PyErr_Fetch()：请改用 PyErr_GetRaisedException()。

• PyErr_NormalizeException()：请改用 PyErr_GetRaisedException()。

• PyErr_Restore()：请改用 PyErr_SetRaisedException()。

• PyModule_GetFilename()：请改用 PyModule_GetFilenameObject()。

• PyOS_AfterFork()：请改用 PyOS_AfterFork_Child()。

• PySlice_GetIndicesEx()：请改用 PySlice_Unpack() 和 PySlice_AdjustIndices()。

• PyUnicode_AsDecodedObject()：请改用 PyCodec_Decode()。

• PyUnicode_AsDecodedUnicode()：请改用 PyCodec_Decode()。

• PyUnicode_AsEncodedObject()：请改用 PyCodec_Encode()。

• PyUnicode_AsEncodedUnicode()：请改用 PyCodec_Encode()。

• PyUnicode_READY()：自 Python 3.12 起不再需要。

• PyErr_Display()：请改用 PyErr_DisplayException()。

• _PyErr_ChainExceptions()：请改用 _PyErr_ChainExceptions1()。

• PyBytesObject.ob_shash 成员：请改为调用 PyObject_Hash()。

• PyDictObject.ma_version_tag 成员。

• 线程局部存储（TLS）API

  • PyThread_create_key()：请改用 PyThread_tss_alloc()。

  • PyThread_delete_key()：请改用 PyThread_tss_free()。

  • PyThread_set_key_value(): 请改用 PyThread_tss_set()。

  • PyThread_get_key_value(): 请改用 PyThread_tss_get()。

  • PyThread_delete_key_value(): 请改用 PyThread_tss_delete()。

  • PyThread_ReInitTLS(): 自 Python 3.7 起不再需要。