# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001-2025, Python Software Foundation

# This file is distributed under the same license as the Python package.

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

#

# Translators:

# Rafael Fontenelle <[email protected]>, 2025

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.12\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2025-07-25 16:03+0000\n"

"PO-Revision-Date: 2025-07-18 19:57+0000\n"

"Last-Translator: Rafael Fontenelle <[email protected]>, 2025\n"

"Language-Team: Chinese (China) (https://app.transifex.com/python-doc/teams/5390/zh_CN/)\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Language: zh_CN\n"

"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../c-api/init_config.rst:7

msgid "Python Initialization Configuration"

msgstr "Python初始化配置"

#: ../../c-api/init_config.rst:11

msgid ""

"Python can be initialized with :c:func:`Py_InitializeFromConfig` and the "

":c:type:`PyConfig` structure. It can be preinitialized with "

":c:func:`Py_PreInitialize` and the :c:type:`PyPreConfig` structure."

msgstr ""

"Python 可以使用 :c:func:`Py_InitializeFromConfig` 和 :c:type:`PyConfig` 结构体来初始化。 "

"它可以使用 :c:func:`Py_PreInitialize` 和 :c:type:`PyPreConfig` 结构体来预初始化。"

#: ../../c-api/init_config.rst:15

msgid "There are two kinds of configuration:"

msgstr "有两种配置方式："

#: ../../c-api/init_config.rst:17

msgid ""

"The :ref:`Python Configuration <init-python-config>` can be used to build a "

"customized Python which behaves as the regular Python. For example, "

"environment variables and command line arguments are used to configure "

"Python."

msgstr ""

":ref:`Python 配置 <init-python-config>` 可被用于构建一个定制的 Python，其行为与常规 Python 类似。 "

"例如，环境变量和命令行参数可被用于配置 Python。"

#: ../../c-api/init_config.rst:22

msgid ""

"The :ref:`Isolated Configuration <init-isolated-conf>` can be used to embed "

"Python into an application. It isolates Python from the system. For example,"

" environment variables are ignored, the LC_CTYPE locale is left unchanged "

"and no signal handler is registered."

msgstr ""

":ref:`隔离配置 <init-isolated-conf>` 可被用于将 Python 嵌入到应用程序。 它将 Python 与系统隔离开来。 "

"例如，环境变量将被忽略，LC_CTYPE 语言区域设置保持不变并且不会注册任何信号处理器。"

#: ../../c-api/init_config.rst:27

msgid ""

"The :c:func:`Py_RunMain` function can be used to write a customized Python "

"program."

msgstr ":c:func:`Py_RunMain` 函数可被用来编写定制的 Python 程序。"

#: ../../c-api/init_config.rst:30

msgid ""

"See also :ref:`Initialization, Finalization, and Threads <initialization>`."

msgstr "参见 :ref:`Initialization, Finalization, and Threads <initialization>`."

#: ../../c-api/init_config.rst:33

msgid ":pep:`587` \"Python Initialization Configuration\"."

msgstr ":pep:`587` \"Python 初始化配置\"."

#: ../../c-api/init_config.rst:37

msgid "Example"

msgstr "示例"

#: ../../c-api/init_config.rst:39

msgid "Example of customized Python always running in isolated mode::"

msgstr "定制的 Python 的示例总是会以隔离模式运行::"

#: ../../c-api/init_config.rst:41

msgid ""

"int main(int argc, char **argv)\n"

"{\n"

" PyStatus status;\n"

"\n"

" PyConfig config;\n"

" PyConfig_InitPythonConfig(&config);\n"

" config.isolated = 1;\n"

"\n"

" /* Decode command line arguments.\n"

" Implicitly preinitialize Python (in isolated mode). */\n"

" status = PyConfig_SetBytesArgv(&config, argc, argv);\n"

" if (PyStatus_Exception(status)) {\n"

" goto exception;\n"

" }\n"

"\n"

" status = Py_InitializeFromConfig(&config);\n"

" if (PyStatus_Exception(status)) {\n"

" goto exception;\n"

" }\n"

" PyConfig_Clear(&config);\n"

"\n"

" return Py_RunMain();\n"

"\n"

"exception:\n"

" PyConfig_Clear(&config);\n"

" if (PyStatus_IsExit(status)) {\n"

" return status.exitcode;\n"

" }\n"

" /* Display the error message and exit the process with\n"

" non-zero exit code */\n"

" Py_ExitStatusException(status);\n"

"}"

msgstr ""

"int main(int argc, char **argv)\n"

"{\n"

" PyStatus status;\n"

"\n"

" PyConfig config;\n"

" PyConfig_InitPythonConfig(&config);\n"

" config.isolated = 1;\n"

"\n"

" /* 解码命令行参数。\n"

" 隐式地预初始化 Python (隔离模式)。 */\n"

" status = PyConfig_SetBytesArgv(&config, argc, argv);\n"

" if (PyStatus_Exception(status)) {\n"

" goto exception;\n"

" }\n"

"\n"

" status = Py_InitializeFromConfig(&config);\n"

" if (PyStatus_Exception(status)) {\n"

" goto exception;\n"

" }\n"

" PyConfig_Clear(&config);\n"

"\n"

" return Py_RunMain();\n"

"\n"

"exception:\n"

" PyConfig_Clear(&config);\n"

" if (PyStatus_IsExit(status)) {\n"

" return status.exitcode;\n"

" }\n"

" /* 显示错误消息然后退出进程\n"

" 并设置非零值退出码 */\n"

" Py_ExitStatusException(status);\n"

"}"

#: ../../c-api/init_config.rst:76

msgid "PyWideStringList"

msgstr "PyWideStringList"

#: ../../c-api/init_config.rst:80

msgid "List of ``wchar_t*`` strings."

msgstr "由 ``wchar_t*`` 字符串组成的列表。"

#: ../../c-api/init_config.rst:82

msgid ""

"If *length* is non-zero, *items* must be non-``NULL`` and all strings must "

"be non-``NULL``."

msgstr "如果 *length* 为非零值，则 *items* 必须不为 ``NULL`` 并且所有字符串均必须不为 ``NULL``。"

#: ../../c-api/init_config.rst:87

msgid "Methods:"

msgstr "方法"

#: ../../c-api/init_config.rst:91

msgid "Append *item* to *list*."

msgstr "将 *item* 添加到 *list*。"

#: ../../c-api/init_config.rst:93 ../../c-api/init_config.rst:104

msgid "Python must be preinitialized to call this function."

msgstr "Python 必须被预初始化以便调用此函数。"

#: ../../c-api/init_config.rst:97

msgid "Insert *item* into *list* at *index*."

msgstr "将 *item* 插入到 *list* 的 *index* 位置上。"

#: ../../c-api/init_config.rst:99

msgid ""

"If *index* is greater than or equal to *list* length, append *item* to "

"*list*."

msgstr "如果 *index* 大于等于 *list* 的长度，则将 *item* 添加到 *list*。"

#: ../../c-api/init_config.rst:102

msgid "*index* must be greater than or equal to ``0``."

msgstr "*index* 必须大于等于 ``0``。"

#: ../../c-api/init_config.rst:108 ../../c-api/init_config.rst:128

#: ../../c-api/init_config.rst:235 ../../c-api/init_config.rst:544

msgid "Structure fields:"

msgstr "结构体字段:"

#: ../../c-api/init_config.rst:112

msgid "List length."

msgstr "List 长度。"

#: ../../c-api/init_config.rst:116

msgid "List items."

msgstr "列表项目。"

#: ../../c-api/init_config.rst:119

msgid "PyStatus"

msgstr "PyStatus"

#: ../../c-api/init_config.rst:123

msgid ""

"Structure to store an initialization function status: success, error or "

"exit."

msgstr "存储初始函数状态：成功、错误或退出的结构体。"

#: ../../c-api/init_config.rst:126

msgid ""

"For an error, it can store the C function name which created the error."

msgstr "对于错误，它可以存储造成错误的 C 函数的名称。"

#: ../../c-api/init_config.rst:132

msgid "Exit code. Argument passed to ``exit()``."

msgstr "退出码。 传给 ``exit()`` 的参数。"

#: ../../c-api/init_config.rst:136

msgid "Error message."

msgstr "错误信息"

#: ../../c-api/init_config.rst:140

msgid "Name of the function which created an error, can be ``NULL``."

msgstr "造成错误的函数的名称，可以为 ``NULL``。"

#: ../../c-api/init_config.rst:144

msgid "Functions to create a status:"

msgstr "创建状态的函数:"

#: ../../c-api/init_config.rst:148

msgid "Success."

msgstr "完成。"

#: ../../c-api/init_config.rst:152

msgid "Initialization error with a message."

msgstr "带消息的初始化错误。"

#: ../../c-api/init_config.rst:154

msgid "*err_msg* must not be ``NULL``."

msgstr "*err_msg* 不可为 ``NULL``。"

#: ../../c-api/init_config.rst:158

msgid "Memory allocation failure (out of memory)."

msgstr "内存分配失败（内存不足）。"

#: ../../c-api/init_config.rst:162

msgid "Exit Python with the specified exit code."

msgstr "以指定的退出代码退出 Python。"

#: ../../c-api/init_config.rst:164

msgid "Functions to handle a status:"

msgstr "处理状态的函数:"

#: ../../c-api/init_config.rst:168

msgid ""

"Is the status an error or an exit? If true, the exception must be handled; "

"by calling :c:func:`Py_ExitStatusException` for example."

msgstr "状态为错误还是退出？如为真值，则异常必须被处理；例如通过调用 :c:func:`Py_ExitStatusException`。"

#: ../../c-api/init_config.rst:173

msgid "Is the result an error?"

msgstr "结果错误吗？"

#: ../../c-api/init_config.rst:177

msgid "Is the result an exit?"

msgstr "结果是否退出？"

#: ../../c-api/init_config.rst:181

msgid ""

"Call ``exit(exitcode)`` if *status* is an exit. Print the error message and "

"exit with a non-zero exit code if *status* is an error. Must only be called"

" if ``PyStatus_Exception(status)`` is non-zero."

msgstr ""

"如果 *status* 是一个退出码则调用 ``exit(exitcode)``。如果 *status* "

"是一个错误码则打印错误消息并设置一个非零退出码再退出。 必须在 ``PyStatus_Exception(status)`` 为非零值时才能被调用。"

#: ../../c-api/init_config.rst:186

msgid ""

"Internally, Python uses macros which set ``PyStatus.func``, whereas "

"functions to create a status set ``func`` to ``NULL``."

msgstr ""

"在内部，Python 将使用设置 ``PyStatus.func`` 的宏，而创建状态的函数则会将 ``func`` 设为 ``NULL``。"

#: ../../c-api/init_config.rst:189

msgid "Example::"

msgstr "示例::"

#: ../../c-api/init_config.rst:191

msgid ""

"PyStatus alloc(void **ptr, size_t size)\n"

"{\n"

" *ptr = PyMem_RawMalloc(size);\n"

" if (*ptr == NULL) {\n"

" return PyStatus_NoMemory();\n"

" }\n"

" return PyStatus_Ok();\n"

"}\n"

"\n"

"int main(int argc, char **argv)\n"

"{\n"

" void *ptr;\n"

" PyStatus status = alloc(&ptr, 16);\n"

" if (PyStatus_Exception(status)) {\n"

" Py_ExitStatusException(status);\n"

" }\n"

" PyMem_Free(ptr);\n"

" return 0;\n"

"}"

msgstr ""

"PyStatus alloc(void **ptr, size_t size)\n"

"{\n"

" *ptr = PyMem_RawMalloc(size);\n"

" if (*ptr == NULL) {\n"

" return PyStatus_NoMemory();\n"

" }\n"

" return PyStatus_Ok();\n"

"}\n"

"\n"

"int main(int argc, char **argv)\n"

"{\n"

" void *ptr;\n"

" PyStatus status = alloc(&ptr, 16);\n"

" if (PyStatus_Exception(status)) {\n"

" Py_ExitStatusException(status);\n"

" }\n"

" PyMem_Free(ptr);\n"

" return 0;\n"

"}"

#: ../../c-api/init_config.rst:213

msgid "PyPreConfig"

msgstr "PyPreConfig"

#: ../../c-api/init_config.rst:217

msgid "Structure used to preinitialize Python."

msgstr "用于预初始化 Python 的结构体。"

#: ../../c-api/init_config.rst:221

msgid "Function to initialize a preconfiguration:"

msgstr "用于初始化预先配置的函数:"

#: ../../c-api/init_config.rst:225

msgid ""

"Initialize the preconfiguration with :ref:`Python Configuration <init-"

"python-config>`."

msgstr "通过 :ref:`Python 配置 <init-python-config>` 来初始化预先配置。"

#: ../../c-api/init_config.rst:230

msgid ""

"Initialize the preconfiguration with :ref:`Isolated Configuration <init-"

"isolated-conf>`."

msgstr "通过 :ref:`隔离配置 <init-isolated-conf>` 来初始化预先配置。"

#: ../../c-api/init_config.rst:239

msgid "Name of the Python memory allocators:"

msgstr "Python 内存分配器名称:"

#: ../../c-api/init_config.rst:241

msgid ""

"``PYMEM_ALLOCATOR_NOT_SET`` (``0``): don't change memory allocators (use "

"defaults)."

msgstr "``PYMEM_ALLOCATOR_NOT_SET`` (``0``): 不改变内存分配器 (使用默认)。"

#: ../../c-api/init_config.rst:243

msgid ""

"``PYMEM_ALLOCATOR_DEFAULT`` (``1``): :ref:`default memory allocators "

"<default-memory-allocators>`."

msgstr ""

"``PYMEM_ALLOCATOR_DEFAULT`` (``1``): :ref:`默认内存分配器 <default-memory-"

"allocators>`。"

#: ../../c-api/init_config.rst:245

msgid ""

"``PYMEM_ALLOCATOR_DEBUG`` (``2``): :ref:`default memory allocators <default-"

"memory-allocators>` with :ref:`debug hooks <pymem-debug-hooks>`."

msgstr ""

"``PYMEM_ALLOCATOR_DEBUG`` (``2``): :ref:`默认内存分配器 <default-memory-"

"allocators>` 附带 :ref:`调试钩子 <pymem-debug-hooks>`。"

#: ../../c-api/init_config.rst:248

msgid "``PYMEM_ALLOCATOR_MALLOC`` (``3``): use ``malloc()`` of the C library."

msgstr "``PYMEM_ALLOCATOR_MALLOC`` (``3``): 使用 C 库的 ``malloc()``。"

#: ../../c-api/init_config.rst:249

msgid ""

"``PYMEM_ALLOCATOR_MALLOC_DEBUG`` (``4``): force usage of ``malloc()`` with "

":ref:`debug hooks <pymem-debug-hooks>`."

msgstr ""

"``PYMEM_ALLOCATOR_MALLOC_DEBUG`` (``4``): 强制使用 ``malloc()`` 附带 :ref:`调试钩子 "

"<pymem-debug-hooks>`。"

#: ../../c-api/init_config.rst:251

msgid ""

"``PYMEM_ALLOCATOR_PYMALLOC`` (``5``): :ref:`Python pymalloc memory allocator"

" <pymalloc>`."

msgstr ""

"``PYMEM_ALLOCATOR_PYMALLOC`` (``5``): :ref:`Python pymalloc 内存分配器 "

"<pymalloc>`。"

#: ../../c-api/init_config.rst:253

msgid ""

"``PYMEM_ALLOCATOR_PYMALLOC_DEBUG`` (``6``): :ref:`Python pymalloc memory "

"allocator <pymalloc>` with :ref:`debug hooks <pymem-debug-hooks>`."

msgstr ""

"``PYMEM_ALLOCATOR_PYMALLOC_DEBUG`` (``6``): :ref:`Python pymalloc 内存分配器 "

"<pymalloc>` 附带 :ref:`调试钩子 <pymem-debug-hooks>`。"

#: ../../c-api/init_config.rst:257

msgid ""

"``PYMEM_ALLOCATOR_PYMALLOC`` and ``PYMEM_ALLOCATOR_PYMALLOC_DEBUG`` are not "

"supported if Python is :option:`configured using --without-pymalloc "

"<--without-pymalloc>`."

msgstr ""

"如果 Python 是 :option:`使用 --without-pymalloc 进行配置 <--without-pymalloc>` 则 "

"``PYMEM_ALLOCATOR_PYMALLOC`` 和 ``PYMEM_ALLOCATOR_PYMALLOC_DEBUG`` 将不被支持。"

#: ../../c-api/init_config.rst:261

msgid "See :ref:`Memory Management <memory>`."

msgstr "参见 :ref:`Memory Management <memory>`."

#: ../../c-api/init_config.rst:263

msgid "Default: ``PYMEM_ALLOCATOR_NOT_SET``."

msgstr "默认值: ``PYMEM_ALLOCATOR_NOT_SET``。"

#: ../../c-api/init_config.rst:267

msgid "Set the LC_CTYPE locale to the user preferred locale."

msgstr "将 LC_CTYPE 语言区域设为用户选择的语言区域。"

#: ../../c-api/init_config.rst:269

msgid ""

"If equals to ``0``, set :c:member:`~PyPreConfig.coerce_c_locale` and "

":c:member:`~PyPreConfig.coerce_c_locale_warn` members to ``0``."

msgstr ""

"如果等于 ``0``，则将 :c:member:`~PyPreConfig.coerce_c_locale` 和 "

":c:member:`~PyPreConfig.coerce_c_locale_warn` 的成员设为 ``0``。"

#: ../../c-api/init_config.rst:272 ../../c-api/init_config.rst:283

msgid "See the :term:`locale encoding`."

msgstr "参见 :term:`locale encoding`。"

#: ../../c-api/init_config.rst:274 ../../c-api/init_config.rst:329

#: ../../c-api/init_config.rst:684

msgid "Default: ``1`` in Python config, ``0`` in isolated config."

msgstr "默认值: 在 Python 配置中为 ``1``，在隔离配置中为 ``0``。"

#: ../../c-api/init_config.rst:278

msgid "If equals to ``2``, coerce the C locale."

msgstr "如果等于 ``2``，强制转换 C 语言区域。"

#: ../../c-api/init_config.rst:280

msgid ""

"If equals to ``1``, read the LC_CTYPE locale to decide if it should be "

"coerced."

msgstr "如果等于 ``1``，则读取 LC_CTYPE 语言区域来确定其是否应当被强制转换。"

#: ../../c-api/init_config.rst:285 ../../c-api/init_config.rst:291

msgid "Default: ``-1`` in Python config, ``0`` in isolated config."

msgstr "默认值: 在 Python 配置中为 ``-1``，在隔离配置中为 ``0``。"

#: ../../c-api/init_config.rst:289

msgid "If non-zero, emit a warning if the C locale is coerced."

msgstr "如为非零值，则会在 C 语言区域被强制转换时发出警告。"

#: ../../c-api/init_config.rst:295

msgid ""

":ref:`Python Development Mode <devmode>`: see :c:member:`PyConfig.dev_mode`."

msgstr ":ref:`Python 开发模式 <devmode>`: 参见 :c:member:`PyConfig.dev_mode`。"

#: ../../c-api/init_config.rst:298 ../../c-api/init_config.rst:693

#: ../../c-api/init_config.rst:735 ../../c-api/init_config.rst:1188

msgid "Default: ``-1`` in Python mode, ``0`` in isolated mode."

msgstr "默认值: 在 Python 模式中为 ``-1``，在隔离模式中为 ``0``。"

#: ../../c-api/init_config.rst:302

msgid "Isolated mode: see :c:member:`PyConfig.isolated`."

msgstr "隔离模式：参见 :c:member:`PyConfig.isolated`。"

#: ../../c-api/init_config.rst:304 ../../c-api/init_config.rst:880

msgid "Default: ``0`` in Python mode, ``1`` in isolated mode."

msgstr "默认值: 在 Python 模式中为 ``0``，在隔离模式中为 ``1``。"

#: ../../c-api/init_config.rst:308

msgid "If non-zero:"

msgstr "如为非零值:"

#: ../../c-api/init_config.rst:310

msgid "Set :c:member:`PyPreConfig.utf8_mode` to ``0``,"

msgstr "设置 :c:member:`PyPreConfig.utf8_mode` 为 ``0``,"

#: ../../c-api/init_config.rst:311

msgid "Set :c:member:`PyConfig.filesystem_encoding` to ``\"mbcs\"``,"

msgstr "设置 :c:member:`PyConfig.filesystem_encoding` 为 ``\"mbcs\"``,"

#: ../../c-api/init_config.rst:312

msgid "Set :c:member:`PyConfig.filesystem_errors` to ``\"replace\"``."

msgstr "设置 :c:member:`PyConfig.filesystem_errors` 为 ``\"replace\"``."

#: ../../c-api/init_config.rst:314

msgid ""

"Initialized from the :envvar:`PYTHONLEGACYWINDOWSFSENCODING` environment "

"variable value."

msgstr "基于 :envvar:`PYTHONLEGACYWINDOWSFSENCODING` 环境变量值完成初始化。"

#: ../../c-api/init_config.rst:317 ../../c-api/init_config.rst:894

msgid ""

"Only available on Windows. ``#ifdef MS_WINDOWS`` macro can be used for "

"Windows specific code."

msgstr "仅在 Windows 上可用。 ``#ifdef MS_WINDOWS`` 宏可被用于 Windows 专属的代码。"

#: ../../c-api/init_config.rst:320 ../../c-api/init_config.rst:632

#: ../../c-api/init_config.rst:639 ../../c-api/init_config.rst:706

#: ../../c-api/init_config.rst:815 ../../c-api/init_config.rst:829

#: ../../c-api/init_config.rst:843 ../../c-api/init_config.rst:897

#: ../../c-api/init_config.rst:911 ../../c-api/init_config.rst:971

#: ../../c-api/init_config.rst:1023 ../../c-api/init_config.rst:1083

#: ../../c-api/init_config.rst:1123 ../../c-api/init_config.rst:1152

#: ../../c-api/init_config.rst:1239

msgid "Default: ``0``."

msgstr "默认值: ``0``."

#: ../../c-api/init_config.rst:324

msgid ""

"If non-zero, :c:func:`Py_PreInitializeFromArgs` and "

":c:func:`Py_PreInitializeFromBytesArgs` parse their ``argv`` argument the "

"same way the regular Python parses command line arguments: see :ref:`Command"

" Line Arguments <using-on-cmdline>`."

msgstr ""

"如为非零值，:c:func:`Py_PreInitializeFromArgs` 和 "

":c:func:`Py_PreInitializeFromBytesArgs` 将以与常规 Python 解析命令行参数的相同方式解析其 "

"``argv`` 参数：参见 :ref:`命令行参数 <using-on-cmdline>`。"

#: ../../c-api/init_config.rst:333

msgid ""

"Use :ref:`environment variables <using-on-envvars>`? See "

":c:member:`PyConfig.use_environment`."

msgstr ""

"使用 :ref:`环境变量 <using-on-envvars>`? 参见 :c:member:`PyConfig.use_environment`。"

#: ../../c-api/init_config.rst:336 ../../c-api/init_config.rst:1213

msgid "Default: ``1`` in Python config and ``0`` in isolated config."

msgstr "默认值: 在 Python 配置中为 ``1`` 而在隔离配置中为 ``0``。"

#: ../../c-api/init_config.rst:340

msgid "If non-zero, enable the :ref:`Python UTF-8 Mode <utf8-mode>`."

msgstr "如为非零值，则启用 :ref:`Python UTF-8 模式 <utf8-mode>`。"

#: ../../c-api/init_config.rst:342

msgid ""

"Set to ``0`` or ``1`` by the :option:`-X utf8 <-X>` command line option and "

"the :envvar:`PYTHONUTF8` environment variable."

msgstr ""

"通过 :option:`-X utf8 <-X>` 命令行选项和 :envvar:`PYTHONUTF8` 环境变量设为 ``0`` 或 ``1``。"

#: ../../c-api/init_config.rst:345

msgid "Also set to ``1`` if the ``LC_CTYPE`` locale is ``C`` or ``POSIX``."

msgstr "如果 ``LC_CTYPE`` 语言区域为 ``C`` 或 ``POSIX`` 也会被设为 ``1``。"

#: ../../c-api/init_config.rst:347

msgid "Default: ``-1`` in Python config and ``0`` in isolated config."

msgstr "默认值: 在 Python 配置中为 ``-1`` 而在隔离配置中为 ``0``。"

#: ../../c-api/init_config.rst:353

msgid "Preinitialize Python with PyPreConfig"

msgstr "使用 PyPreConfig 预初始化 Python"

#: ../../c-api/init_config.rst:355

msgid "The preinitialization of Python:"

msgstr "Python 的预初始化:"

#: ../../c-api/init_config.rst:357

msgid "Set the Python memory allocators (:c:member:`PyPreConfig.allocator`)"

msgstr "设置 Python 内存分配器 (:c:member:`PyPreConfig.allocator`)"

#: ../../c-api/init_config.rst:358

msgid "Configure the LC_CTYPE locale (:term:`locale encoding`)"

msgstr "配置 LC_CTYPE 语言区域 (:term:`locale encoding`)"

#: ../../c-api/init_config.rst:359

msgid ""

"Set the :ref:`Python UTF-8 Mode <utf8-mode>` "

"(:c:member:`PyPreConfig.utf8_mode`)"

msgstr ""

"设置 :ref:`Python UTF-8 模式 <utf8-mode>` (:c:member:`PyPreConfig.utf8_mode`)"

#: ../../c-api/init_config.rst:362

msgid ""

"The current preconfiguration (``PyPreConfig`` type) is stored in "

"``_PyRuntime.preconfig``."

msgstr "当前的预配置 (``PyPreConfig`` 类型) 保存在 ``_PyRuntime.preconfig`` 中。"

#: ../../c-api/init_config.rst:365

msgid "Functions to preinitialize Python:"

msgstr "用于预初始化 Python 的函数："

#: ../../c-api/init_config.rst:369 ../../c-api/init_config.rst:375

#: ../../c-api/init_config.rst:384

msgid "Preinitialize Python from *preconfig* preconfiguration."

msgstr "根据 *preconfig* 预配置来预初始化 Python。"

#: ../../c-api/init_config.rst:371 ../../c-api/init_config.rst:380

#: ../../c-api/init_config.rst:389

msgid "*preconfig* must not be ``NULL``."

msgstr "*preconfig* 不可为 ``NULL``。"

#: ../../c-api/init_config.rst:377

msgid ""

"Parse *argv* command line arguments (bytes strings) if "

":c:member:`~PyPreConfig.parse_argv` of *preconfig* is non-zero."

msgstr ""

"如果 *preconfig* 的 :c:member:`~PyPreConfig.parse_argv` 为非零值则解析 *argv* "

"命令行参数（字节串）。"

#: ../../c-api/init_config.rst:386

msgid ""

"Parse *argv* command line arguments (wide strings) if "

":c:member:`~PyPreConfig.parse_argv` of *preconfig* is non-zero."

msgstr ""

"如果 *preconfig* 的 :c:member:`~PyPreConfig.parse_argv` 为非零值则解析 *argv* "

"命令行参数（宽字符串）。"

#: ../../c-api/init_config.rst:391 ../../c-api/init_config.rst:1301

msgid ""

"The caller is responsible to handle exceptions (error or exit) using "

":c:func:`PyStatus_Exception` and :c:func:`Py_ExitStatusException`."

msgstr ""

"调用方要负责使用 :c:func:`PyStatus_Exception` 和 :c:func:`Py_ExitStatusException` "

"来处理异常（错误或退出）。"

#: ../../c-api/init_config.rst:394

msgid ""

"For :ref:`Python Configuration <init-python-config>` "

"(:c:func:`PyPreConfig_InitPythonConfig`), if Python is initialized with "

"command line arguments, the command line arguments must also be passed to "

"preinitialize Python, since they have an effect on the pre-configuration "

"like encodings. For example, the :option:`-X utf8 <-X>` command line option "

"enables the :ref:`Python UTF-8 Mode <utf8-mode>`."

msgstr ""

"对于 :ref:`Python 配置 <init-python-config>` "

"(:c:func:`PyPreConfig_InitPythonConfig`)，如果 Python 是用命令行参数初始化的，那么在预初始化 "

"Python 时也必须传递命令行参数，因为它们会对编码格式等预配置产生影响。 例如，:option:`-X utf8<-X>` 命令行选项将启用 "

":ref:`Python UTF-8 模式<utf8-mode>`。"

#: ../../c-api/init_config.rst:401

msgid ""

"``PyMem_SetAllocator()`` can be called after :c:func:`Py_PreInitialize` and "

"before :c:func:`Py_InitializeFromConfig` to install a custom memory "

"allocator. It can be called before :c:func:`Py_PreInitialize` if "

":c:member:`PyPreConfig.allocator` is set to ``PYMEM_ALLOCATOR_NOT_SET``."

msgstr ""

"``PyMem_SetAllocator()`` 可在 :c:func:`Py_PreInitialize` "

"之后、:c:func:`Py_InitializeFromConfig` 之前被调用以安装自定义的内存分配器。 如果 "

":c:member:`PyPreConfig.allocator` 被设为 ``PYMEM_ALLOCATOR_NOT_SET`` 则可在 "

":c:func:`Py_PreInitialize` 之前被调用。"

#: ../../c-api/init_config.rst:406

msgid ""

"Python memory allocation functions like :c:func:`PyMem_RawMalloc` must not "

"be used before the Python preinitialization, whereas calling directly "

"``malloc()`` and ``free()`` is always safe. :c:func:`Py_DecodeLocale` must "

"not be called before the Python preinitialization."

msgstr ""

"像 :c:func:`PyMem_RawMalloc` 这样的 Python 内存分配函数不能在 Python 预初始化之前使用，而直接调用 "

"``malloc()`` 和 ``free()`` 则始终会是安全的。 :c:func:`Py_DecodeLocale` 不能在 Python "

"预初始化之前被调用。"

#: ../../c-api/init_config.rst:411

msgid ""

"Example using the preinitialization to enable the :ref:`Python UTF-8 Mode "

"<utf8-mode>`::"

msgstr "使用预初始化来启用 :ref:`Python UTF-8 模式 <utf8-mode>` 的例子::"

#: ../../c-api/init_config.rst:414

msgid ""

"PyStatus status;\n"

"PyPreConfig preconfig;\n"

"PyPreConfig_InitPythonConfig(&preconfig);\n"

"\n"

"preconfig.utf8_mode = 1;\n"

"\n"

"status = Py_PreInitialize(&preconfig);\n"

"if (PyStatus_Exception(status)) {\n"

" Py_ExitStatusException(status);\n"

"}\n"

"\n"

"/* at this point, Python speaks UTF-8 */\n"

"\n"

"Py_Initialize();\n"

"/* ... use Python API here ... */\n"

"Py_Finalize();"

msgstr ""

"PyStatus status;\n"

"PyPreConfig preconfig;\n"

"PyPreConfig_InitPythonConfig(&preconfig);\n"

"\n"

"preconfig.utf8_mode = 1;\n"

"\n"

"status = Py_PreInitialize(&preconfig);\n"

"if (PyStatus_Exception(status)) {\n"

" Py_ExitStatusException(status);\n"

"}\n"

"\n"

"/* 此时，Python 将使用 UTF-8 */\n"

"\n"

"Py_Initialize();\n"

"/* ... 在此使用 Python API ... */\n"

"Py_Finalize();"

#: ../../c-api/init_config.rst:433

msgid "PyConfig"

msgstr "PyConfig"

#: ../../c-api/init_config.rst:437

msgid "Structure containing most parameters to configure Python."

msgstr "包含了大部分用于配置 Python 的形参的结构体。"

#: ../../c-api/init_config.rst:439

msgid ""

"When done, the :c:func:`PyConfig_Clear` function must be used to release the"

" configuration memory."

msgstr "在完成后，必须使用 :c:func:`PyConfig_Clear` 函数来释放配置内存。"

#: ../../c-api/init_config.rst:444

msgid "Structure methods:"

msgstr "结构体方法:"

#: ../../c-api/init_config.rst:448

msgid ""

"Initialize configuration with the :ref:`Python Configuration <init-python-"

"config>`."

msgstr "通过 :ref:`Python 配置 <init-python-config>` 来初始化配置。"

#: ../../c-api/init_config.rst:453

msgid ""

"Initialize configuration with the :ref:`Isolated Configuration <init-"

"isolated-conf>`."

msgstr "通过 :ref:`隔离配置 <init-isolated-conf>` 来初始化配置。"

#: ../../c-api/init_config.rst:458

msgid "Copy the wide character string *str* into ``*config_str``."

msgstr "将宽字符串 *str* 拷贝至 ``*config_str``。"

#: ../../c-api/init_config.rst:460 ../../c-api/init_config.rst:467

#: ../../c-api/init_config.rst:474 ../../c-api/init_config.rst:482

#: ../../c-api/init_config.rst:488 ../../c-api/init_config.rst:505

msgid ":ref:`Preinitialize Python <c-preinit>` if needed."

msgstr "在必要时 :ref:`预初始化 Python <c-preinit>`。"

#: ../../c-api/init_config.rst:464

msgid ""

"Decode *str* using :c:func:`Py_DecodeLocale` and set the result into "

"``*config_str``."

msgstr "使用 :c:func:`Py_DecodeLocale` 对 *str* 进行解码并将结果设置到 ``*config_str``。"

#: ../../c-api/init_config.rst:471

msgid ""

"Set command line arguments (:c:member:`~PyConfig.argv` member of *config*) "

"from the *argv* list of wide character strings."

msgstr "根据宽字符串列表 *argv* 设置命令行参数 (*config* 的 :c:member:`~PyConfig.argv` 成员)。"

#: ../../c-api/init_config.rst:478

msgid ""

"Set command line arguments (:c:member:`~PyConfig.argv` member of *config*) "

"from the *argv* list of bytes strings. Decode bytes using "

":c:func:`Py_DecodeLocale`."

msgstr ""

"根据字节串列表 *argv* 设置命令行参数 (*config* 的 :c:member:`~PyConfig.argv` 成员)。 使用 "

":c:func:`Py_DecodeLocale` 对字节串进行解码。"

#: ../../c-api/init_config.rst:486

msgid "Set the list of wide strings *list* to *length* and *items*."

msgstr "将宽字符串列表 *list* 设置为 *length* 和 *items*。"

#: ../../c-api/init_config.rst:492

msgid "Read all Python configuration."

msgstr "读取所有 Python 配置。"

#: ../../c-api/init_config.rst:494

msgid "Fields which are already initialized are left unchanged."

msgstr "已经初始化的字段会保持不变。"

#: ../../c-api/init_config.rst:496

msgid ""

"Fields for :ref:`path configuration <init-path-config>` are no longer "

"calculated or modified when calling this function, as of Python 3.11."

msgstr "调用此函数时不再计算或修改用于 :ref:`路径配置 <init-path-config>` 的字段，如 Python 3.11 那样。"

#: ../../c-api/init_config.rst:499 ../../c-api/init_config.rst:1000

msgid ""

"The :c:func:`PyConfig_Read` function only parses :c:member:`PyConfig.argv` "

"arguments once: :c:member:`PyConfig.parse_argv` is set to ``2`` after "

"arguments are parsed. Since Python arguments are stripped from "

":c:member:`PyConfig.argv`, parsing arguments twice would parse the "

"application options as Python options."

msgstr ""

":c:func:`PyConfig_Read` 函数对 :c:member:`PyConfig.argv` 参数只会解析一次：在参数解析完成后 "

":c:member:`PyConfig.parse_argv` 将被设为 ``2``。 由于 Python 参数是从 "

":c:member:`PyConfig.argv` 提取的，因此解析参数两次会将应用程序选项解析为 Python 选项。"

#: ../../c-api/init_config.rst:507

msgid ""

"The :c:member:`PyConfig.argv` arguments are now only parsed once, "

":c:member:`PyConfig.parse_argv` is set to ``2`` after arguments are parsed, "

"and arguments are only parsed if :c:member:`PyConfig.parse_argv` equals "

"``1``."

msgstr ""

":c:member:`PyConfig.argv` "

"参数现在只会被解析一次，在参数解析完成后，:c:member:`PyConfig.parse_argv` 将被设为 ``2``，只有当 "

":c:member:`PyConfig.parse_argv` 等于 ``1`` 时才会解析参数。"

#: ../../c-api/init_config.rst:513

msgid ""

":c:func:`PyConfig_Read` no longer calculates all paths, and so fields listed"

" under :ref:`Python Path Configuration <init-path-config>` may no longer be "

"updated until :c:func:`Py_InitializeFromConfig` is called."

msgstr ""

":c:func:`PyConfig_Read` 不会再计算所有路径，因此在 :ref:`Python 路径配置 <init-path-config>` "

"下列出的字段可能不会再更新直到 :c:func:`Py_InitializeFromConfig` 被调用。"

#: ../../c-api/init_config.rst:521

msgid "Release configuration memory."

msgstr "释放配置内存"

#: ../../c-api/init_config.rst:523

msgid ""

"Most ``PyConfig`` methods :ref:`preinitialize Python <c-preinit>` if needed."

" In that case, the Python preinitialization configuration "

"(:c:type:`PyPreConfig`) in based on the :c:type:`PyConfig`. If configuration"

" fields which are in common with :c:type:`PyPreConfig` are tuned, they must "

"be set before calling a :c:type:`PyConfig` method:"

msgstr ""

"如有必要大多数 ``PyConfig`` 方法将会 :ref:`预初始化 Python <c-preinit>`。 在这种情况下，Python "

"预初始化配置 (:c:type:`PyPreConfig`) 将以 :c:type:`PyConfig` 为基础。 如果要调整与 "

":c:type:`PyPreConfig` 相同的配置字段，它们必须在调用 :c:type:`PyConfig` 方法之前被设置："

#: ../../c-api/init_config.rst:529

msgid ":c:member:`PyConfig.dev_mode`"

msgstr ":c:member:`PyConfig.dev_mode`"

#: ../../c-api/init_config.rst:530

msgid ":c:member:`PyConfig.isolated`"

msgstr ":c:member:`PyConfig.isolated`"

#: ../../c-api/init_config.rst:531

msgid ":c:member:`PyConfig.parse_argv`"

msgstr ":c:member:`PyConfig.parse_argv`"

#: ../../c-api/init_config.rst:532

msgid ":c:member:`PyConfig.use_environment`"

msgstr ":c:member:`PyConfig.use_environment`"

#: ../../c-api/init_config.rst:534

msgid ""

"Moreover, if :c:func:`PyConfig_SetArgv` or :c:func:`PyConfig_SetBytesArgv` "

"is used, this method must be called before other methods, since the "

"preinitialization configuration depends on command line arguments (if "

":c:member:`~PyConfig.parse_argv` is non-zero)."

msgstr ""

"此外，如果使用了 :c:func:`PyConfig_SetArgv` 或 "

":c:func:`PyConfig_SetBytesArgv`，则必须在调用其他方法之前调用该方法，因为预初始化配置取决于命令行参数（如果 "

":c:member:`~PyConfig.parse_argv` 为非零值）。"

#: ../../c-api/init_config.rst:539

msgid ""

"The caller of these methods is responsible to handle exceptions (error or "

"exit) using ``PyStatus_Exception()`` and ``Py_ExitStatusException()``."

msgstr ""

"这些方法的调用者要负责使用 ``PyStatus_Exception()`` 和 ``Py_ExitStatusException()`` "

"来处理异常（错误或退出）。"

#: ../../c-api/init_config.rst:548

msgid "Command line arguments: :data:`sys.argv`."

msgstr "命令行参数: :data:`sys.argv`。"

#: ../../c-api/init_config.rst:550

msgid ""

"Set :c:member:`~PyConfig.parse_argv` to ``1`` to parse "

":c:member:`~PyConfig.argv` the same way the regular Python parses Python "

"command line arguments and then to strip Python arguments from "

":c:member:`~PyConfig.argv`."

msgstr ""

"将 :c:member:`~PyConfig.parse_argv` 设为 ``1`` 将以与普通 Python 解析 Python "

"命令行参数相同的方式解析 :c:member:`~PyConfig.argv` 再从 :c:member:`~PyConfig.argv` 中剥离 "

"Python 参数。"

#: ../../c-api/init_config.rst:555

msgid ""

"If :c:member:`~PyConfig.argv` is empty, an empty string is added to ensure "

"that :data:`sys.argv` always exists and is never empty."

msgstr ""

"如果 :c:member:`~PyConfig.argv` 为空，则会添加一个空字符串以确保 :data:`sys.argv` 始终存在并且永远不为空。"

#: ../../c-api/init_config.rst:558 ../../c-api/init_config.rst:585

#: ../../c-api/init_config.rst:597 ../../c-api/init_config.rst:605

#: ../../c-api/init_config.rst:713 ../../c-api/init_config.rst:722

#: ../../c-api/init_config.rst:804 ../../c-api/init_config.rst:941

#: ../../c-api/init_config.rst:1042 ../../c-api/init_config.rst:1060

#: ../../c-api/init_config.rst:1074 ../../c-api/init_config.rst:1091

#: ../../c-api/init_config.rst:1104 ../../c-api/init_config.rst:1112

msgid "Default: ``NULL``."

msgstr "默认值: ``NULL``."

#: ../../c-api/init_config.rst:560

msgid "See also the :c:member:`~PyConfig.orig_argv` member."

msgstr "另请参阅 :c:member:`~PyConfig.orig_argv` 成员。"

#: ../../c-api/init_config.rst:564

msgid ""

"If equals to zero, ``Py_RunMain()`` prepends a potentially unsafe path to "

":data:`sys.path` at startup:"

msgstr "如果等于零，``Py_RunMain()`` 会在启动时向 :data:`sys.path` 开头添加一个可能不安全的路径:"

#: ../../c-api/init_config.rst:567

msgid ""

"If :c:member:`argv[0] <PyConfig.argv>` is equal to ``L\"-m\"`` (``python -m "

"module``), prepend the current working directory."

msgstr ""

"如果 :c:member:`argv[0] <PyConfig.argv>` 等于 ``L\"-m\"`` (``python -m "

"module``)，则添加当前工作目录。"

#: ../../c-api/init_config.rst:569

msgid ""

"If running a script (``python script.py``), prepend the script's directory."

" If it's a symbolic link, resolve symbolic links."

msgstr "如果是运行脚本 (``python script.py``)，则添加脚本的目录。 如果是符号链接，则会解析符号链接。"

#: ../../c-api/init_config.rst:571

msgid ""

"Otherwise (``python -c code`` and ``python``), prepend an empty string, "

"which means the current working directory."

msgstr "在其他情况下 (``python -c code`` 和 ``python``)，将添加一个空字符串，这表示当前工作目录。"

#: ../../c-api/init_config.rst:574

msgid ""

"Set to ``1`` by the :option:`-P` command line option and the "

":envvar:`PYTHONSAFEPATH` environment variable."

msgstr "通过 :option:`-P` 命令行选项和 :envvar:`PYTHONSAFEPATH` 环境变量设置为 ``1``。"

#: ../../c-api/init_config.rst:577

msgid "Default: ``0`` in Python config, ``1`` in isolated config."

msgstr "默认值：Python 配置中为 ``0``，隔离配置中为 ``1``。"

#: ../../c-api/init_config.rst:583

msgid ":data:`sys.base_exec_prefix`."

msgstr ":data:`sys.base_exec_prefix`."

#: ../../c-api/init_config.rst:587 ../../c-api/init_config.rst:599

#: ../../c-api/init_config.rst:607 ../../c-api/init_config.rst:715

#: ../../c-api/init_config.rst:724 ../../c-api/init_config.rst:958

#: ../../c-api/init_config.rst:1044

msgid ""

"Part of the :ref:`Python Path Configuration <init-path-config>` output."

msgstr ":ref:`Python 路径配置 <init-path-config>` 的一部分。"

#: ../../c-api/init_config.rst:591

msgid "Python base executable: :data:`sys._base_executable`."

msgstr "Python 基础可执行文件: :data:`sys._base_executable`。"

#: ../../c-api/init_config.rst:593

msgid "Set by the :envvar:`__PYVENV_LAUNCHER__` environment variable."

msgstr "由 :envvar:`__PYVENV_LAUNCHER__` 环境变量设置。"

#: ../../c-api/init_config.rst:595

msgid "Set from :c:member:`PyConfig.executable` if ``NULL``."

msgstr "如为 ``NULL`` 则从 :c:member:`PyConfig.executable` 设置。"

#: ../../c-api/init_config.rst:603

msgid ":data:`sys.base_prefix`."

msgstr ":data:`sys.base_prefix`."

#: ../../c-api/init_config.rst:611

msgid ""

"If equals to ``0`` and :c:member:`~PyConfig.configure_c_stdio` is non-zero, "

"disable buffering on the C streams stdout and stderr."

msgstr ""

"如果等于 ``0`` 且 :c:member:`~PyConfig.configure_c_stdio` 为非零值，则禁用 C 数据流 stdout 和"

" stderr 的缓冲。"

#: ../../c-api/init_config.rst:614

msgid ""

"Set to ``0`` by the :option:`-u` command line option and the "

":envvar:`PYTHONUNBUFFERED` environment variable."

msgstr "通过 :option:`-u` 命令行选项和 :envvar:`PYTHONUNBUFFERED` 环境变量设置为 ``0``。"

#: ../../c-api/init_config.rst:617

msgid "stdin is always opened in buffered mode."

msgstr "stdin 始终以缓冲模式打开。"

#: ../../c-api/init_config.rst:619 ../../c-api/init_config.rst:652

#: ../../c-api/init_config.rst:1140 ../../c-api/init_config.rst:1271

msgid "Default: ``1``."

msgstr "默认值: ``1``."

#: ../../c-api/init_config.rst:623

msgid ""