使用PyO3开发Python库遇PyList未实现Clone trait错误

问题原因 #

PyList作为PyO3中代表Python列表的类型，本身没有实现Clone trait。当你为Crust结构体添加#[derive(Clone)]时，编译器会强制要求所有字段都实现Clone，因此触发报错。直接使用&PyList引用会引入生命周期参数，但PyO3的#[pyclass]不支持带生命周期的泛型结构体，导致这种方式不可行。

解决方案 #

方案1：改用PyObject存储 #

PyObject实现了Clone trait，可以作为中间类型存储Python列表对象，需要操作时再转换回PyList：

use pyo3::types::PyList;
use pyo3::prelude::*;

#[pyclass(unsendable)]
#[derive(Clone)]
struct Crust {
    #[pyo3(get, set)]
    arguments: PyObject,
}

#[pymethods]
impl Crust {
    #[new]
    fn new(arguments: PyList) -> Self {
        Crust { arguments: arguments.into() }
    }

    fn add_argument(&self, name: String, callback: PyObject) -> PyResult<()> {
        Python::with_gil(|py| {
            // 将PyObject转换回PyList
            let list = self.arguments.as_ref(py).downcast::<PyList>()?;
            println!("Current arguments: {:?}", list);
            // 示例：向列表添加元素
            list.append((name, callback))?;
            Ok(())
        })
    }
}

#[pymodule]
fn crust(_py: Python, m: &PyModule) -> PyResult<()> {
    m.add_class::<Crust>()?;
    Ok(())
}

方案2：手动实现Clone trait #

利用PyO3提供的clone_ref方法（所有Python对象类型都支持），手动为Crust实现Clone，无需依赖derive宏：

use pyo3::types::PyList;
use pyo3::prelude::*;

#[pyclass(unsendable)]
struct Crust {
    #[pyo3(get, set)]
    arguments: PyList,
}

// 手动实现Clone，通过clone_ref创建新的PyList句柄
impl Clone for Crust {
    fn clone(&self) -> Self {
        Python::with_gil(|py| {
            Crust {
                arguments: self.arguments.clone_ref(py),
            }
        })
    }
}

#[pymethods]
impl Crust {
    #[new]
    fn new(arguments: PyList) -> Self {
        Crust { arguments }
    }

    fn add_argument(&self, name: String, callback: PyObject) -> PyResult<()> {
        Python::with_gil(|py| {
            println!("Current arguments: {:?}", self.arguments);
            self.arguments.append((name, callback))?;
            Ok(())
        })
    }
}

#[pymodule]
fn crust(_py: Python, m: &PyModule) -> PyResult<()> {
    m.add_class::<Crust>()?;
    Ok(())
}

方案选择 #

• 若需要频繁在PyList和存储类型间转换，方案1更简洁；
• 若希望保持字段类型为PyList，方案2能直接满足需求，且避免类型转换开销。

内容的提问来源于stack exchange，提问作者Brody Critchlow