为封装HashMap的结构体引用实现IntoIterator trait

问题核心 #

你遇到的错误是因为HashMap::into_iter()会转移整个HashMap的所有权，但self是&Headers（不可变引用），Rust不允许从共享引用后方移动内部数据，因此编译报错。我们需要实现基于引用的迭代，而非消耗式迭代。

修正后的完整代码 #

use std::collections::HashMap;
use std::collections::hash_map::Iter;

struct Headers {
    headers: HashMap<String, String>,
}

impl Headers {
    pub fn new(headers: HashMap<String, String>) -> Self {
        Self { headers }
    }
}

// 为不可变引用&Headers实现IntoIterator
impl<'a> IntoIterator for &'a Headers {
    // 迭代返回的是HashMap键值对的不可变引用
    type Item = (&'a String, &'a String);
    // 使用HashMap的不可变迭代器类型
    type IntoIter = Iter<'a, String, String>;

    fn into_iter(self) -> Self::IntoIter {
        // 调用HashMap的iter()方法，返回借用式迭代器
        self.headers.iter()
    }
}

struct Response {
    headers: Headers,
}

impl Response {
    pub fn new(headers: Headers) -> Self {
        Self { headers }
    }

    pub fn headers(&self) -> &Headers {
        &self.headers
    }
}

fn main() {
    let mut headers = HashMap::new();
    headers.insert("foo".to_string(), "one".to_string());
    headers.insert("bar".to_string(), "two".to_string());
    let response = Response::new(Headers::new(headers));

    // 现在可以正常迭代头信息
    for (key, value) in response.headers() {
        println!("{}: {}", key, value);
    }
}

关键修正说明 #

1. 迭代器类型选择：用HashMap::iter()替代into_iter()，前者返回的是Iter迭代器，仅借用HashMap中的数据，不会转移所有权，完全适配共享引用场景。
2. 关联类型调整：
   • Item改为(&'a String, &'a String)，对应迭代器返回的引用类型
   • IntoIter指定为Iter<'a, String, String>，即HashMap的不可变迭代器类型
3. 生命周期绑定：添加生命周期参数'a，确保迭代器的引用生命周期与&Headers的生命周期一致，避免悬垂引用。

进阶优化（可选） #

如果希望迭代时直接获取&str而非&String，可以通过map转换迭代器输出，让类型更通用：

impl<'a> IntoIterator for &'a Headers {
    type Item = (&'a str, &'a str);
    // 使用impl Iterator简化类型声明
    type IntoIter = impl Iterator<Item = (&'a str, &'a str)>;

    fn into_iter(self) -> Self::IntoIter {
        self.headers.iter().map(|(k, v)| (k.as_str(), v.as_str()))
    }
}

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