本文详解如何使用 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<'_, PyAny>) -> PyResult<usize> {
// 调用 Python 函数 f，传入单个位置参数 (a,)
let result = f.call1((a,))?;
// 将 Python 返回值解析为 Rust 的 usize 类型
result.extract::<usize>()
}
#[pymodule]
fn rust_module(_py: Python, m: &Bound<'_, PyModule>) -> PyResult<()> {
m.add_function(wrap_pyfunction!(my_rust_function, m)?)?;
Ok(())
}对应 Python 使用方式如下：
import rust_module
def double(x):
return 2 * x
def main():
result = rust_module.my_rust_function(3, double)
print(result) # 输出: 6
return result✅ 注意事项与最佳实践：
立即学习“Python免费学习笔记（深入）”；
- 始终优先使用
Bound（而非Py<pyany></pyany>）接收 Python 对象：它具备生命周期约束，更安全且零拷贝；仅当需跨PythonGIL 生命周期持有对象时才考虑Py<t></t>。 -
call1((a,))中的元组必须显式加逗号（(a,)），否则 Rust 会将其视为普通括号表达式而非单元素元组。 - 所有 Python 调用均可能抛出异常（如
TypeError、ZeroDivisionError），因此务必用?向上传播PyResult，由 PyO3 自动转换为对应的 Python 异常。 - 若需传递多个参数或关键字参数，可改用
f.call((a, b), Some(kwargs))?，其中kwargs是&PyDict。 - Rust 函数签名中避免使用
&PyAny—— 它缺少必要的生命周期和所有权信息，编译将失败。
这种设计不仅支持普通函数，也兼容 functools.partial、绑定方法（bound method）、甚至实现了 __call__ 的自定义类实例，真正实现了灵活、健壮的跨语言函数式编程范式。
