本文介绍如何使用 SWIG 的 %pythonbegin 指令，在自动生成的 Python 包装文件最顶端（早于 _FOO 模块导入）插入关键依赖导入（如 import BAR），确保底层 C/C++ 库正确加载。

本文介绍如何使用 swig 的 `%pythonbegin` 指令，在自动生成的 python 包装文件最顶端（早于 `_foo` 模块导入）插入关键依赖导入（如 `import bar`），确保底层 c/c++ 库正确加载。

在使用 SWIG 封装 C/C++ 库时，有时需满足特定的运行时依赖顺序——例如，目标模块 _FOO 的加载依赖于另一个 Python 模块 BAR（可能用于初始化全局状态、注册符号、设置环境钩子等）。而默认生成的包装文件中，import _FOO 位于靠前位置，直接在 .i 接口文件中使用 %pythoncode 会将其插入到 _FOO 导入之后，无法满足前置依赖要求。

此时，应使用 SWIG 提供的 %pythonbegin 指令。该指令专为向生成的 Python 文件最顶部（即 from sys import version_info as _swig_python_version_info 之前）注入代码而设计，优先级高于所有其他 %pythoncode 片段。

✅ 正确做法：在你的 SWIG 接口文件（如 foo.i）顶部添加：

%pythonbegin %{
import BAR
%}

⚠️ 注意事项：

Claw Code Suite (Python-Only Edition)

仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...

下载

立即学习“Python免费学习笔记（深入）”；

• %pythonbegin 必须置于 %module 声明之前（或至少在任何 %pythoncode 之前），否则可能被忽略；
• %{ ... %} 中的内容将被原样写入生成 Python 文件的第一行，因此需确保语法合法（如避免缩进、不引入未声明变量）；
• 若 BAR 是相对导入（如 from . import bar），请确保其路径语义与最终包结构一致，并考虑配合 %package 或 __package__ 逻辑调整；
• 验证效果：运行 swig -python foo.i 后检查生成的 foo.py，确认 import BAR 出现在 from sys import version_info... 之前。

? 进阶提示：若需条件导入（如仅在特定 Python 版本或平台下导入 BAR），也可在 %pythonbegin 中编写完整逻辑：

%pythonbegin %{
import sys
if sys.platform == "linux":
    import BAR
%}

通过 %pythonbegin，你可精准控制 Python 包装层的初始化顺序，彻底解决因加载时序导致的底层库初始化失败问题。