計劃在 Python 3.15 中移除

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

• PyWeakref_GetObject() 和 PyWeakref_GET_OBJECT()：請改用 PyWeakref_GetRef()。 pythoncapi-compat 專案 可用於在 Python 3.12 及更早版本中獲取 PyWeakref_GetRef()。

• 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()：請改用 PyConfig_Get("module_search_paths")（sys.path）。

  • Py_GetPrefix()：請改用 PyConfig_Get("base_prefix") （sys.base_prefix）。如果需要處理虛擬環境，請使用 PyConfig_Get("prefix") （sys.prefix）。

  • Py_GetExecPrefix()：請改用 PyConfig_Get("base_exec_prefix") （sys.base_exec_prefix）。如果需要處理虛擬環境，請使用 PyConfig_Get("exec_prefix") （sys.exec_prefix）。

  • Py_GetProgramFullPath()：請改用 PyConfig_Get("executable")（sys.executable）。

  • Py_GetProgramName()：請改用 PyConfig_Get("executable")（sys.executable）。

  • Py_GetPythonHome()：請改用 PyConfig_Get("home") 或 PYTHONHOME 環境變數。

  可以使用 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()：請改用清空 sys.warnoptions 和 warnings.filters。

  應使用 Py_InitializeFromConfig() API 與 PyConfig 配合使用。

• 全域性配置變數

  • Py_DebugFlag：請改用 PyConfig.parser_debug 或 PyConfig_Get("parser_debug")。

  • Py_VerboseFlag：請改用 PyConfig.verbose 或 PyConfig_Get("verbose")。

  • Py_QuietFlag：請改用 PyConfig.quiet 或 PyConfig_Get("quiet")。

  • 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()）

  應使用 Py_InitializeFromConfig() API 與 PyConfig 一起設定這些選項。或者，可以使用 PyConfig_Get() 在執行時獲取這些選項。