为何Rust中对不可变引用调用map会引发部分所有权转移？

问题根源 #

你遇到的错误核心是：数组的map方法会获取原数组元素的所有权。

原代码中player_hand.cards.map(|card| card.suit)调用的是数组[Card;5]的原生map方法，它的签名要求接收self（即数组的所有权）。闭包|card| card.suit会将每个Card的suit取出，同时原Card的所有权会被转移到闭包中并消耗——这就导致player_hand.cards的元素被部分转移，后续无法再完整使用player_hand结构体。

你误以为是“不可变引用调用map”，但实际上这里的map直接作用在cards数组本身上，而非引用，所以触发了所有权转移。

修复方案 #

方案1：使用引用迭代器（推荐） #

通过iter()获取数组的不可变引用迭代器，这样不会转移任何元素的所有权，仅读取suit的引用进行判断：

use itertools::Itertools;

fn find_hand_value(player_hand: Hand) {
    let is_flush = player_hand.cards.iter().map(|card| &card.suit).all_equal();
    // ... 其他检查逻辑
    println!("{:?}", player_hand);
    // 返回手牌价值
}

这里iter()返回&Card的迭代器，map生成&Suit的迭代器，all_equal()会自动解引用比较suit的实际值（因为Suit实现了PartialEq），完全不影响原数组的所有权。

方案2：克隆Suit（如需所有权） #

如果需要获取suit的所有权而非引用，可给Suit派生Clone trait，然后克隆每个suit：
首先修改Suit的定义：

#[derive(Debug, PartialEq, Eq, Clone)]
enum Suit {
    Hearts,
    Diamonds,
    Spades,
    Clubs,
}

再调整函数代码：

use itertools::Itertools;

fn find_hand_value(player_hand: Hand) {
    let is_flush = player_hand.cards.iter().map(|card| card.suit.clone()).all_equal();
    // ... 其他检查逻辑
    println!("{:?}", player_hand);
    // 返回手牌价值
}

iter()保证原数组不被移动，clone()仅复制suit的值，原Card和Hand的所有权保持完整。

补充说明 #

数组原生map方法的设计目的是基于原数组生成新数组，因此必须获取原数组的所有权。如果只是要遍历数组进行读取操作，优先使用iter()（不可变引用）或iter_mut()（可变引用），避免不必要的所有权转移。

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