PyWideStringList

PyWideStringList 是一个 wchar_t* 字符串列表。

PyWideStringList 结构字段

• length (Py_ssize_t)
• items (wchar_t**)

方法

• PyStatus PyWideStringList_Append(PyWideStringList *list, const wchar_t *item): 将 _item_ 附加到 _list_。
• PyStatus PyWideStringList_Insert(PyWideStringList *list, Py_ssize_t index, const wchar_t *item): 在 _list_ 的 _index_ 处插入 _item_。如果 _index_ 大于 _list_ 长度，则将 _item_ 附加到 _list_。

如果 _length_ 不为零，则 _items_ 必须不为 NULL，并且所有字符串必须不为 NULL。

PyStatus

PyStatus 是一种结构，用于存储初始化函数的状：成功、错误或退出。对于错误，它可以存储创建错误的 C 函数名称。

示例

PyStatus alloc(void **ptr, size_t size)
{
    *ptr = PyMem_RawMalloc(size);
    if (*ptr == NULL) {
        return PyStatus_NoMemory();
    }
    return PyStatus_Ok();
}

int main(int argc, char **argv)
{
    void *ptr;
    PyStatus status = alloc(&ptr, 16);
    if (PyStatus_Exception(status)) {
        Py_ExitStatusException(status);
    }
    PyMem_Free(ptr);
    return 0;
}

PyStatus 字段

• exitcode (int): 传递给 exit() 的参数。
• err_msg (const char*): 错误消息。
• func (const char *): 创建错误的函数名称，可以是 NULL。
• 私有 _type 字段：仅供内部使用。

用于创建状态的函数

• PyStatus_Ok(): 成功。
• PyStatus_Error(err_msg): 带有消息的初始化错误。
• PyStatus_NoMemory(): 内存分配失败（内存不足）。
• PyStatus_Exit(exitcode): 以指定的退出代码退出 Python。

处理状态的函数

• PyStatus_Exception(status): 结果是错误还是退出？如果为真，则必须处理异常；例如，通过调用 Py_ExitStatusException(status)。
• PyStatus_IsError(status): 结果是错误吗？
• PyStatus_IsExit(status): 结果是退出吗？
• Py_ExitStatusException(status): 如果 _status_ 是退出，则调用 exit(exitcode)。如果 _status_ 是错误，则打印错误消息并以非零退出代码退出。只有在 PyStatus_Exception(status) 为真时才应调用。

使用 PyPreConfig 进行预初始化

PyPreConfig 结构用于预初始化 Python

• 设置 Python 内存分配器
• 配置 LC_CTYPE 区域设置
• 设置 UTF-8 模式

使用预初始化启用 UTF-8 模式的示例

PyStatus status;
PyPreConfig preconfig;

PyPreConfig_InitPythonConfig(&preconfig);

preconfig.utf8_mode = 1;

status = Py_PreInitialize(&preconfig);
if (PyStatus_Exception(status)) {
    Py_ExitStatusException(status);
}

/* at this point, Python will speak UTF-8 */

Py_Initialize();
/* ... use Python API here ... */
Py_Finalize();

初始化预配置的函数

• PyStatus PyPreConfig_InitIsolatedConfig(PyPreConfig *preconfig)
• PyStatus PyPreConfig_InitPythonConfig(PyPreConfig *preconfig)

预初始化 Python 的函数

• PyStatus Py_PreInitialize(const PyPreConfig *preconfig)
• PyStatus Py_PreInitializeFromBytesArgs(const PyPreConfig *preconfig, int argc, char * const *argv)
• PyStatus Py_PreInitializeFromArgs(const PyPreConfig *preconfig, int argc, wchar_t * const * argv)

调用者有责任使用 PyStatus_Exception() 和 Py_ExitStatusException() 处理异常（错误或退出）。

对于Python 配置 (PyPreConfig_InitPythonConfig())，如果 Python 是用命令行参数初始化的，那么命令行参数也必须传递给预初始化 Python，因为它们对预配置（如编码）有影响。例如，-X utf8 命令行选项启用 UTF-8 模式。

PyPreConfig 字段

• allocator (int): 内存分配器的名称（例如：PYMEM_ALLOCATOR_MALLOC）。有效值
  • PYMEM_ALLOCATOR_NOT_SET (0): 不改变内存分配器（使用默认值）
  • PYMEM_ALLOCATOR_DEFAULT (1): 默认内存分配器
  • PYMEM_ALLOCATOR_DEBUG (2): 带有调试钩子的默认内存分配器
  • PYMEM_ALLOCATOR_MALLOC (3): 强制使用 malloc()
  • PYMEM_ALLOCATOR_MALLOC_DEBUG (4): 强制使用带有调试钩子的 malloc()
  • PYMEM_ALLOCATOR_PYMALLOC (5): Python “pymalloc” 分配器
  • PYMEM_ALLOCATOR_PYMALLOC_DEBUG (6): 带有调试钩子的 Python “pymalloc” 分配器
  • 注意：如果 Python 使用 --without-pymalloc 配置，则不支持 PYMEM_ALLOCATOR_PYMALLOC 和 PYMEM_ALLOCATOR_PYMALLOC_DEBUG
• configure_locale (int): 将 LC_CTYPE 区域设置为用户首选区域？如果等于 0，则将 coerce_c_locale 和 coerce_c_locale_warn 设置为 0。
• coerce_c_locale (int): 如果等于 2，则强制 C 区域设置；如果等于 1，则读取 LC_CTYPE 区域设置以决定是否应强制。
• coerce_c_locale_warn (int): 如果非零，则在强制 C 区域设置时发出警告。
• dev_mode (int): 请参阅 PyConfig.dev_mode。
• isolated (int): 请参阅 PyConfig.isolated。
• legacy_windows_fs_encoding (int, 仅限 Windows): 如果非零，则禁用 UTF-8 模式，将 Python 文件系统编码设置为 mbcs，将文件系统错误处理程序设置为 replace。
• parse_argv (int): 如果非零，Py_PreInitializeFromArgs() 和 Py_PreInitializeFromBytesArgs() 以与常规 Python 解析命令行参数相同的方式解析其 argv 参数：请参阅 命令行参数。
• use_environment (int): 请参阅 PyConfig.use_environment。
• utf8_mode (int): 如果非零，则启用 UTF-8 模式。

legacy_windows_fs_encoding 字段仅在 Windows 上可用。#ifdef MS_WINDOWS 宏可用于 Windows 特定的代码。

PyPreConfig 私有字段，仅供内部使用

• _config_init (int): 用于初始化 PyConfig 的函数，用于预初始化。

PyMem_SetAllocator() 可以在 Py_PreInitialize() 之后和 Py_InitializeFromConfig() 之前调用，以安装自定义内存分配器。如果 allocator 设置为 PYMEM_ALLOCATOR_NOT_SET（默认值），则可以在 Py_PreInitialize() 之前调用。

Python 内存分配函数（如 PyMem_RawMalloc()）在 Python 预初始化之前不得使用，而直接调用 malloc() 和 free() 始终是安全的。Py_DecodeLocale() 在预初始化之前不得调用。

使用 PyConfig 进行初始化

PyConfig 结构包含配置 Python 的大多数参数。

设置程序名称的示例

void init_python(void)
{
    PyStatus status;

    PyConfig config;
    PyConfig_InitPythonConfig(&config);

    /* Set the program name. Implicitly preinitialize Python. */
    status = PyConfig_SetString(&config, &config.program_name,
                                L"/path/to/my_program");
    if (PyStatus_Exception(status)) {
        goto fail;
    }

    status = Py_InitializeFromConfig(&config);
    if (PyStatus_Exception(status)) {
        goto fail;
    }
    PyConfig_Clear(&config);
    return;

fail:
    PyConfig_Clear(&config);
    Py_ExitStatusException(status);
}

PyConfig 方法

• void PyConfig_InitPythonConfig(PyConfig *config) 使用Python 配置初始化配置。
• void PyConfig_InitIsolatedConfig(PyConfig *config): 使用隔离配置初始化配置。
• PyStatus PyConfig_SetString(PyConfig *config, wchar_t * const *config_str, const wchar_t *str): 将宽字符字符串 _str_ 复制到 *config_str。如果需要，预初始化 Python。
• PyStatus PyConfig_SetBytesString(PyConfig *config, wchar_t * const *config_str, const char *str): 使用 Py_DecodeLocale() 解码 _str_ 并将结果设置到 *config_str。如果需要，预初始化 Python。
• PyStatus PyConfig_SetArgv(PyConfig *config, int argc, wchar_t * const *argv): 从宽字符字符串设置命令行参数。如果需要，预初始化 Python。
• PyStatus PyConfig_SetBytesArgv(PyConfig *config, int argc, char * const *argv): 设置命令行参数：使用 Py_DecodeLocale() 解码字节。如果需要，预初始化 Python。
• PyStatus PyConfig_Read(PyConfig *config): 读取所有 Python 配置。已经初始化的字段保持不变。如果需要，预初始化 Python。
• void PyConfig_Clear(PyConfig *config): 释放配置内存。

大多数 PyConfig 方法会在需要时预初始化 Python。在这种情况下，Python 预初始化配置基于 PyConfig。如果与 PyPreConfig 共同的配置字段被调整，它们必须在调用 PyConfig 方法之前设置

• dev_mode
• isolated
• parse_argv
• use_environment

此外，如果使用了 PyConfig_SetArgv() 或 PyConfig_SetBytesArgv()，则此方法必须首先调用，在其他方法之前，因为预初始化配置依赖于命令行参数（如果 parse_argv 非零）。

初始化 Python 的函数

• PyStatus Py_InitializeFromConfig(const PyConfig *config): 从 _config_ 配置初始化 Python。

这些方法和函数的调用者有责任使用 PyStatus_Exception() 和 Py_ExitStatusException() 处理异常（错误或退出）。

PyConfig 字段

• argv (PyWideStringList): 命令行参数，sys.argv。请参阅 parse_argv 以与常规 Python 解析 Python 命令行参数相同的方式解析 argv。如果 argv 为空，则添加一个空字符串以确保 sys.argv 始终存在且不为空。
• base_exec_prefix (wchar_t*): sys.base_exec_prefix。
• base_prefix (wchar_t*): sys.base_prefix。
• buffered_stdio (int): 如果等于 0，则启用无缓冲模式，使 stdout 和 stderr 流无缓冲。
• bytes_warning (int): 如果等于 1，则在比较 bytes 或 bytearray 与 str，或比较 bytes 与 int 时发出警告。如果等于或大于 2，则引发 BytesWarning 异常。
• check_hash_pycs_mode (wchar_t*): --check-hash-based-pycs 命令行选项值（请参阅 PEP 552）。有效值：always、never 和 default。默认值为 default。
• configure_c_stdio (int): 如果非零，则配置 C 标准流（stdio、stdout、stdout）。例如，在 Windows 上将其模式设置为 O_BINARY。
• dev_mode (int): 开发模式
• dump_refs (int): 如果非零，则在退出时转储所有仍然存活的对象。需要使用定义了 Py_REF_DEBUG 宏的特殊 Python 构建。
• exec_prefix (wchar_t*): sys.exec_prefix。
• executable (wchar_t*): sys.executable。
• faulthandler (int): 如果非零，则调用 faulthandler.enable()。
• filesystem_encoding (wchar_t*): 文件系统编码，sys.getfilesystemencoding()。
• filesystem_errors (wchar_t*): 文件系统编码错误，sys.getfilesystemencodeerrors()。
• use_hash_seed (int), hash_seed (unsigned long): 随机哈希函数种子。
• home (wchar_t*): Python 主目录。
• import_time (int): 如果非零，则分析导入时间。
• inspect (int): 执行脚本或命令后进入交互模式。
• install_signal_handlers (int): 安装信号处理程序？
• interactive (int): 交互模式。
• isolated (int): 如果大于 0，则启用隔离模式
  • sys.path 既不包含脚本目录（从 argv[0] 或当前目录计算），也不包含用户 site-packages 目录。
  • Python REPL 不导入 readline，也不在交互式提示符下启用默认 readline 配置。
  • 将 use_environment 和 user_site_directory 设置为 0。
• legacy_windows_stdio (int, 仅限 Windows): 如果非零，则对 sys.stdin、sys.stdout 和 sys.stderr 使用 io.FileIO 而不是 WindowsConsoleIO。
• malloc_stats (int): 如果非零，则在退出时转储 pymalloc 内存分配器的统计信息。如果 Python 使用 --without-pymalloc 构建，则忽略此选项。
• pythonpath_env (wchar_t*): 模块搜索路径，作为由 DELIM（通常是 : 字符）分隔的字符串。默认情况下从 PYTHONPATH 环境变量值初始化。
• module_search_paths_set (int), module_search_paths (PyWideStringList): sys.path。如果 module_search_paths_set 等于 0，则 module_search_paths 将被计算路径配置的函数覆盖。
• optimization_level (int): 编译优化级别
  • 0: 窥孔优化器（并且 __debug__ 设置为 True）
  • 1: 删除断言，将 __debug__ 设置为 False
  • 2: 剥离文档字符串
• parse_argv (int): 如果非零，则以与常规 Python 命令行参数相同的方式解析 argv，并从 argv 中剥离 Python 参数：请参阅 命令行参数。
• parser_debug (int): 如果非零，则打开解析器调试输出（仅限专家，取决于编译选项）。
• pathconfig_warnings (int): 如果等于 0，则在计算路径配置时禁止警告（仅限 Unix，Windows 不记录任何警告）。否则，警告将写入 stderr。
• prefix (wchar_t*): sys.prefix。
• program_name (wchar_t*): 程序名称。
• pycache_prefix (wchar_t*): .pyc 缓存前缀。
• quiet (int): 静默模式。例如，即使在交互模式下也不显示版权和版本信息。
• run_command (wchar_t*): python3 -c COMMAND 参数。
• run_filename (wchar_t*): python3 FILENAME 参数。
• run_module (wchar_t*): python3 -m MODULE 参数。
• show_alloc_count (int): 在退出时显示分配计数？需要使用定义了 COUNT_ALLOCS 宏的特殊 Python 构建。
• show_ref_count (int): 在退出时显示总引用计数？需要 Python 的调试构建（应定义 Py_REF_DEBUG 宏）。
• site_import (int): 在启动时导入 site 模块？
• skip_source_first_line (int): 跳过源代码的第一行？
• stdio_encoding (wchar_t*), stdio_errors (wchar_t*): sys.stdin, sys.stdout 和 sys.stderr 的编码和编码错误。
• tracemalloc (int): 如果非零，则调用 tracemalloc.start(value)。
• user_site_directory (int): 如果非零，则将用户站点目录添加到 sys.path。
• verbose (int): 如果非零，则启用详细模式。
• warnoptions (PyWideStringList): warnings 模块的选项，用于构建警告过滤器。
• write_bytecode (int): 如果非零，则写入 .pyc 文件。
• xoptions (PyWideStringList): sys._xoptions。

legacy_windows_stdio 字段仅在 Windows 上可用。#ifdef MS_WINDOWS 宏可用于 Windows 特定的代码。

如果 parse_argv 非零，则 argv 参数以与常规 Python 解析命令行参数相同的方式进行解析，并且 Python 参数将从 argv 中剥离：请参阅 命令行参数。

xoptions 选项被解析以设置其他选项：请参阅 -X 选项。

PyConfig 私有字段，仅供内部使用

• _config_init (int): 用于初始化 PyConfig 的函数，用于预初始化。
• _install_importlib (int): 安装 importlib？
• _init_main (int): 如果等于 0，则在“main”阶段之前停止 Python 初始化（请参阅 PEP 432）。

更完整的示例，修改默认配置，读取配置，然后覆盖一些参数

PyStatus init_python(const char *program_name)
{
    PyStatus status;

    PyConfig config;
    PyConfig_InitPythonConfig(&config);

    /* Set the program name before reading the configuration
       (decode byte string from the locale encoding).

       Implicitly preinitialize Python. */
    status = PyConfig_SetBytesString(&config, &config.program_name,
                                  program_name);
    if (PyStatus_Exception(status)) {
        goto done;
    }

    /* Read all configuration at once */
    status = PyConfig_Read(&config);
    if (PyStatus_Exception(status)) {
        goto done;
    }

    /* Append our custom search path to sys.path */
    status = PyWideStringList_Append(&config.module_search_paths,
                                  L"/path/to/more/modules");
    if (PyStatus_Exception(status)) {
        goto done;
    }

    /* Override executable computed by PyConfig_Read() */
    status = PyConfig_SetString(&config, &config.executable,
                                L"/path/to/my_executable");
    if (PyStatus_Exception(status)) {
        goto done;
    }

    status = Py_InitializeFromConfig(&config);

done:
    PyConfig_Clear(&config);
    return status;
}

隔离配置

PyPreConfig_InitIsolatedConfig() 和 PyConfig_InitIsolatedConfig() 函数创建配置以将 Python 与系统隔离。例如，将 Python 嵌入到应用程序中。

此配置忽略全局配置变量、环境变量和命令行参数（argv 不被解析）。C 标准流（例如：stdout）和 LC_CTYPE 区域设置默认保持不变。

配置文件仍用于此配置。设置路径配置（“输出字段”）以忽略这些配置文件并避免计算默认路径配置的函数。

Python 配置

PyPreConfig_InitPythonConfig() 和 PyConfig_InitPythonConfig() 函数创建用于构建行为与常规 Python 相同的定制 Python 的配置。

环境变量和命令行参数用于配置 Python，而全局配置变量被忽略。

此函数根据 LC_CTYPE 区域设置、PYTHONUTF8 和 PYTHONCOERCECLOCALE 环境变量启用 C 区域强制转换 (PEP 538) 和 UTF-8 模式 (PEP 540)。

始终在隔离模式下运行的自定义 Python 示例

int main(int argc, char **argv)
{
    PyStatus status;

    PyConfig config;
    PyConfig_InitPythonConfig(&config);

    config.isolated = 1;

    /* Decode command line arguments.
       Implicitly preinitialize Python (in isolated mode). */
    status = PyConfig_SetBytesArgv(&config, argc, argv);
    if (PyStatus_Exception(status)) {
        goto fail;
    }

    status = Py_InitializeFromConfig(&config);
    if (PyStatus_Exception(status)) {
        goto fail;
    }
    PyConfig_Clear(&config);

    return Py_RunMain();

fail:
    PyConfig_Clear(&config);
    if (PyStatus_IsExit(status)) {
        return status.exitcode;
    }
    /* Display the error message and exit the process with
       non-zero exit code */
    Py_ExitStatusException(status);
}

此示例是 PEP 432 中讨论的“系统 Python 可执行文件”的基本实现。

路径配置

PyConfig 包含多个路径配置字段

• 路径配置输入字段
  • home
  • pythonpath_env
  • pathconfig_warnings
• 路径配置输出字段
  • exec_prefix
  • executable
  • prefix
  • module_search_paths_set, module_search_paths

如果至少一个“输出字段”未设置，Python 会计算路径配置以填充未设置的字段。如果 module_search_paths_set 等于 0，则 module_search_paths 将被覆盖，module_search_paths_set 将设置为 1。

可以通过显式设置上面列出的所有路径配置输出字段来完全忽略计算默认路径配置的函数。即使字符串非空，也被认为是已设置的。module_search_paths 如果 module_search_paths_set 设置为 1，则被认为是已设置的。在这种情况下，路径配置输入字段也被忽略。

将 pathconfig_warnings 设置为 0，以在计算路径配置时抑制警告（仅限 Unix，Windows 不记录任何警告）。

如果 base_prefix 或 base_exec_prefix 字段未设置，它们将分别从 prefix 和 exec_prefix 继承其值。

Py_RunMain() 和 Py_Main() 修改 sys.path

• 如果 run_filename 已设置且是包含 __main__.py 脚本的目录，则将 run_filename 添加到 sys.path 的开头。
• 如果 isolated 为零
  • 如果 run_module 已设置，则将当前目录添加到 sys.path 的开头。如果无法读取当前目录，则不执行任何操作。
  • 如果 run_filename 已设置，则将文件名所在的目录添加到 sys.path 的开头。
  • 否则，将一个空字符串添加到 sys.path 的开头。

如果 site_import 非零，则 sys.path 可由 site 模块修改。如果 user_site_directory 非零且用户 site-package 目录存在，则 site 模块将用户 site-package 目录附加到 sys.path。

另请参阅路径配置使用的配置文件。

Py_BytesMain()

Python 3.7 提供了一个高级 Py_Main() 函数，该函数要求将命令行参数作为 wchar_t* 字符串传递。使用正确的编码解码字节并非易事。Python 在 C 区域强制转换和 UTF-8 模式方面有其自身的一系列问题。

本 PEP 添加了一个新的 Py_BytesMain() 函数，它将命令行参数作为字节

int Py_BytesMain(int argc, char **argv)

Py_RunMain()

新的 Py_RunMain() 函数执行命令行或配置中指定的命令 (PyConfig.run_command)、脚本 (PyConfig.run_filename) 或模块 (PyConfig.run_module)，然后完成 Python。它返回一个可以传递给 exit() 函数的退出状态。

int Py_RunMain(void);

有关使用 Py_RunMain() 始终在隔离模式下运行的定制 Python 示例，请参阅Python 配置。

多阶段初始化私有临时 API

本节是引入多阶段初始化的私有临时 API，这是 PEP 432 的核心功能

• “核心”初始化阶段，“最少 Python”
  • 内置类型；
  • 内置异常；
  • 内置和冻结模块；
  • sys 模块仅部分初始化（例如：sys.path 尚不存在）；
• “主”初始化阶段，Python 完全初始化
  • 安装并配置 importlib；
  • 应用路径配置；
  • 安装信号处理程序；
  • 完成 sys 模块初始化（例如：创建 sys.stdout 和 sys.path）；
  • 启用可选功能，如 faulthandler 和 tracemalloc；
  • 导入 site 模块；
  • 等等。

私有临时 API

• PyConfig._init_main: 如果设置为 0，Py_InitializeFromConfig() 在“Core”初始化阶段停止。
• PyStatus _Py_InitializeMain(void): 移动到“主”初始化阶段，完成 Python 初始化。

在“核心”阶段不导入任何模块，并且 importlib 模块未配置：路径配置仅在“主”阶段应用。这可能允许在 Python 中自定义 Python，以覆盖或调整路径配置，或许安装自定义 sys.meta_path 导入器或导入钩子等。

在核心阶段之后和主阶段之前，在 Python 中计算路径配置成为可能，这是 PEP 432 的一个动机。

“核心”阶段尚未明确定义：在该阶段应该可用和不应该可用的内容尚未指定。该 API 被标记为私有和临时：在设计出适当的公共 API 之前，该 API 可以随时修改甚至删除。

在“核心”和“主”初始化阶段之间运行 Python 代码的示例

void init_python(void)
{
    PyStatus status;

    PyConfig config;
    PyConfig_InitPythonConfig(&config);

    config._init_main = 0;

    /* ... customize 'config' configuration ... */

    status = Py_InitializeFromConfig(&config);
    PyConfig_Clear(&config);
    if (PyStatus_Exception(status)) {
        Py_ExitStatusException(status);
    }

    /* Use sys.stderr because sys.stdout is only created
       by _Py_InitializeMain() */
    int res = PyRun_SimpleString(
        "import sys; "
        "print('Run Python code before _Py_InitializeMain', "
               "file=sys.stderr)");
    if (res < 0) {
        exit(1);
    }

    /* ... put more configuration code here ... */

    status = _Py_InitializeMain();
    if (PyStatus_Exception(status)) {
        Py_ExitStatusException(status);
    }
}

Python 和隔离配置的比较

PyPreConfig_InitPythonConfig() 和 PyPreConfig_InitIsolatedConfig() 之间的差异

PyConfig_InitPythonConfig() 和 PyConfig_InitIsolatedConfig() 之间的差异

优先级和规则

配置参数的优先级，从高到低

• PyConfig
• PyPreConfig
• 配置文件
• 命令行选项
• 环境变量
• 全局配置变量

警告选项的优先级，从高到低

• PyConfig.warnoptions
• PySys_AddWarnOption()
• PyConfig.bytes_warning（如果大于 1 则添加 "error::BytesWarning" 过滤器，如果等于 1 则添加 "default::BytesWarning 过滤器）
• -W opt 命令行参数
• PYTHONWARNINGS 环境变量
• PyConfig.dev_mode（添加 "default" 过滤器）

关于 PyConfig 参数的规则

• 如果 isolated 非零，则 use_environment 和 user_site_directory 设置为 0。
• 如果 dev_mode 非零，则 allocator 设置为 "debug"，faulthandler 设置为 1，并且 "default" 过滤器添加到 warnoptions。但是 PYTHONMALLOC 环境变量在设置内存分配器方面优先于 dev_mode。
• 如果 base_prefix 未设置，它将继承 prefix 的值。
• 如果 base_exec_prefix 未设置，它将继承 exec_prefix 的值。
• 如果 python._pth 配置文件存在，则 isolated 设置为 1 且 site_import 设置为 0；但如果 python._pth 包含 import site，则 site_import 设置为 1。

关于 PyConfig 和 PyPreConfig 参数的规则

• 如果 PyPreConfig.legacy_windows_fs_encoding 非零，则将 PyPreConfig.utf8_mode 设置为 0，将 PyConfig.filesystem_encoding 设置为 mbcs，并将 PyConfig.filesystem_errors 设置为 replace。

配置文件

由路径配置使用的 Python 配置文件

• pyvenv.cfg
• python._pth（仅限 Windows）
• pybuilddir.txt（仅限 Unix）

全局配置变量

映射到 PyPreConfig 字段的全局配置变量

(NOT) 表示 PyPreConfig 值与全局配置变量值相反。Py_LegacyWindowsFSEncodingFlag 仅在 Windows 上可用。

映射到 PyConfig 字段的全局配置变量

(NOT) 表示 PyConfig 值与全局配置变量值相反。Py_LegacyWindowsStdioFlag 仅在 Windows 上可用。

命令行参数

用法

python3 [options]
python3 [options] -c COMMAND
python3 [options] -m MODULE
python3 [options] SCRIPT

映射到 PyPreConfig 字段的伪操作的命令行选项

映射到 PyConfig 字段的伪操作的命令行选项

-h、-? 和 -V 选项在没有 PyConfig 的情况下处理。

-X 选项

-X 选项映射到 PyConfig 字段的伪操作

环境变量

映射到 PyPreConfig 字段的环境变量

映射到 PyConfig 字段的环境变量

PYTHONLEGACYWINDOWSFSENCODING 和 PYTHONLEGACYWINDOWSSTDIO 仅适用于 Windows。

默认 Python 配置

PyPreConfig_InitPythonConfig():

• allocator = PYMEM_ALLOCATOR_NOT_SET
• coerce_c_locale_warn = -1
• coerce_c_locale = -1
• configure_locale = 1
• dev_mode = -1
• isolated = 0
• legacy_windows_fs_encoding = -1
• use_environment = 1
• utf8_mode = -1

PyConfig_InitPythonConfig():

• argv = []
• base_exec_prefix = NULL
• base_prefix = NULL
• buffered_stdio = 1
• bytes_warning = 0
• check_hash_pycs_mode = NULL
• configure_c_stdio = 1
• dev_mode = 0
• dump_refs = 0
• exec_prefix = NULL
• executable = NULL
• faulthandler = 0
• filesystem_encoding = NULL
• filesystem_errors = NULL
• hash_seed = 0
• home = NULL
• import_time = 0
• inspect = 0
• install_signal_handlers = 1
• interactive = 0
• isolated = 0
• malloc_stats = 0
• module_search_path_env = NULL
• module_search_paths = []
• optimization_level = 0
• parse_argv = 1
• parser_debug = 0
• pathconfig_warnings = 1
• prefix = NULL
• program_name = NULL
• pycache_prefix = NULL
• quiet = 0
• run_command = NULL
• run_filename = NULL
• run_module = NULL
• show_alloc_count = 0
• show_ref_count = 0
• site_import = 1
• skip_source_first_line = 0
• stdio_encoding = NULL
• stdio_errors = NULL
• tracemalloc = 0
• use_environment = 1
• use_hash_seed = 0
• user_site_directory = 1
• verbose = 0
• warnoptions = []
• write_bytecode = 1
• xoptions = []
• _init_main = 1
• _install_importlib = 1

默认隔离配置

PyPreConfig_InitIsolatedConfig():

• allocator = PYMEM_ALLOCATOR_NOT_SET
• coerce_c_locale_warn = 0
• coerce_c_locale = 0
• configure_locale = 0
• dev_mode = 0
• isolated = 1
• legacy_windows_fs_encoding = 0
• use_environment = 0
• utf8_mode = 0

PyConfig_InitIsolatedConfig():

• argv = []
• base_exec_prefix = NULL
• base_prefix = NULL
• buffered_stdio = 1
• bytes_warning = 0
• check_hash_pycs_mode = NULL
• configure_c_stdio = 0
• dev_mode = 0
• dump_refs = 0
• exec_prefix = NULL
• executable = NULL
• faulthandler = 0
• filesystem_encoding = NULL
• filesystem_errors = NULL
• hash_seed = 0
• home = NULL
• import_time = 0
• inspect = 0
• install_signal_handlers = 0
• interactive = 0
• isolated = 1
• malloc_stats = 0
• module_search_path_env = NULL
• module_search_paths = []
• optimization_level = 0
• parse_argv = 0
• parser_debug = 0
• pathconfig_warnings = 0
• prefix = NULL
• program_name = NULL
• pycache_prefix = NULL
• quiet = 0
• run_command = NULL
• run_filename = NULL
• run_module = NULL
• show_alloc_count = 0
• show_ref_count = 0
• site_import = 1
• skip_source_first_line = 0
• stdio_encoding = NULL
• stdio_errors = NULL
• tracemalloc = 0
• use_environment = 0
• use_hash_seed = 0
• user_site_directory = 0
• verbose = 0
• warnoptions = []
• write_bytecode = 1
• xoptions = []
• _init_main = 1
• _install_importlib = 1

Python 3.7 API

Python 3.7在其C API中有4个函数用于初始化和终结Python

• Py_Initialize(), Py_InitializeEx(): 初始化 Python
• Py_Finalize(), Py_FinalizeEx(): 终结 Python

Python 3.7可以通过全局配置变量、环境变量和以下函数进行配置

• PyImport_AppendInittab()
• PyImport_ExtendInittab()
• PyMem_SetAllocator()
• PyMem_SetupDebugHooks()
• PyObject_SetArenaAllocator()
• Py_SetPath()
• Py_SetProgramName()
• Py_SetPythonHome()
• Py_SetStandardStreamEncoding()
• PySys_AddWarnOption()
• PySys_AddXOption()
• PySys_ResetWarnOptions()

还有一个高级的Py_Main()函数和可以被重写的PyImport_FrozenModules变量。

参阅初始化、终结和线程文档。