如何在 PyO3 中实现 Python 函数作为参数传入 Rust 并回调-Python教程-PHP中文网

如何在 PyO3 中实现 Python 函数作为参数传入 Rust 并回调

本文详解如何使用 PyO3 实现「Python 主导调用 Rust 函数，且该 Rust 函数可接收并执行传入的 Python 函数」的双向交互模式，核心在于正确使用 Bound

本文详解如何使用 pyo3 实现「python 主导调用 rust 函数，且该 rust 函数可接收并执行传入的 python 函数」的双向交互模式，核心在于正确使用 `bound` 类型与 `call1()` 等方法完成安全、高效的跨语言函数调用。

在 PyO3 生态中，实现 Python → Rust → Python 的闭环调用是完全可行的，且无需复杂胶水代码。关键在于：Rust 侧需以 Bound 类型接收任意 Python 可调用对象（如函数、lambda、类实例等），再通过其提供的 call0()、call1() 或 call() 方法发起反向调用，并用 .extract::<t>()</t> 安全提取返回值。

以下是一个完整、可运行的示例：

use pyo3::prelude::*;

#[pyfunction]
fn my_rust_function(a: usize, f: Bound) -> PyResult<usize> {
    // 调用 Python 函数 f，传入单个位置参数 (a,)
    let result = f.call1((a,))?;
    // 将 Python 返回值解析为 Rust 的 usize 类型
    result.extract::<usize>()
}

#[pymodule]
fn rust_module(_py: Python, m: &Bound) -> PyResult {
    m.add_function(wrap_pyfunction!(my_rust_function, m)?)?;
    Ok(())
}</usize></usize>

对应 Python 使用方式如下：

Claw Code Suite (Python-Only Edition)

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

下载

import rust_module

def double(x):
    return 2 * x

def main():
    result = rust_module.my_rust_function(3, double)
    print(result)  # 输出: 6
    return result

✅ 注意事项与最佳实践：

始终优先使用 Bound（而非 Py<pyany></pyany>）接收 Python 对象：它具备生命周期约束，更安全且零拷贝；仅当需跨 Python GIL 生命周期持有对象时才考虑 Py<t></t>。
call1((a,)) 中的元组必须显式加逗号（(a,)），否则 Rust 会将其视为普通括号表达式而非单元素元组。
所有 Python 调用均可能抛出异常（如 TypeError、ZeroDivisionError），因此务必用 ? 向上传播 PyResult，由 PyO3 自动转换为对应的 Python 异常。
若需传递多个参数或关键字参数，可改用 f.call((a, b), Some(kwargs))?，其中 kwargs 是 &PyDict。
Rust 函数签名中避免使用 &PyAny —— 它缺少必要的生命周期和所有权信息，编译将失败。