如何通过PyO3在Rust类方法中引用Python整数？

核心问题原因 #

PyO3无法将Python整数直接转换为&i32类型，因为&i32没有实现FromPyObject trait（报错信息已明确说明）。Python中的整数是堆分配对象，而Rust的&i32是栈上值的引用，两者内存模型不匹配，无法直接映射。你不需要也不应该为i32实现PyClass——PyClass仅用于标记要暴露给Python的自定义Rust结构体，基础数值类型不需要这个trait。

解决方案 #

直接将方法参数改为i32（值传递），在方法内部通过&key的方式传递引用给HashMap的方法即可。同时优化原代码中可能触发panic的逻辑：

修改后的get_entry方法 #

fn get_entry(&self, key: i32) -> Option<DataEntry> {
    // 用get方法替代索引访问，避免key不存在时panic
    self.entries.get(&key).cloned()
}

完整修改后的代码片段 #

#[pyclass]
pub struct DataMap {
    entries: HashMap<i32, DataEntry>,
}
#[pymethods]
impl DataMap {
    #[new]
    fn new() -> DataMap {
        DataMap {
            entries: HashMap::new(),
        }
    }
    fn insert(&mut self, key: i32, x: i32, y: i32) {
        let entry = DataEntry::new(x, y);
        self.entries.insert(key, entry);
    }
    fn get_entry(&self, key: i32) -> Option<DataEntry> {
        self.entries.get(&key).cloned()
    }
}

补充说明 #

• i32是Copy类型，值传递的开销可以忽略，完全无需纠结引用传递的问题。
• 使用HashMap::get替代直接索引（self.entries[key]），能避免key不存在时触发panic，更符合Rust的错误处理习惯，同时直接返回Option<&DataEntry>，调用cloned()后即可得到Option<DataEntry>，完美匹配方法的返回类型。

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