如何解决Rust中使用calamine读取Excel时的‘值已移动’错误？

我想用calamine读取Excel文件，先通过workbook获取工作表名称，再遍历所有工作表读取内容，但在for循环中将workbook传递给handle_sheet函数时出现错误。

源代码 #

use std::{fs::File, io::BufReader};
use calamine::{open_workbook_auto, DataType, Reader, Sheets};

pub fn read_to_workbook(filename: String) {
    let workbook = open_workbook_auto(filename).expect("Cannot open file");

    let sheets = workbook.sheet_names().to_owned();
    for sheet_name in &sheets {
        handle_sheet(sheet_name.to_string(), workbook);
    }
}

fn handle_sheet(sheet_name: String, mut workbook: Sheets<BufReader<File>>) {
    if let Some(Ok(range)) = workbook.worksheet_range(&sheet_name) {
        // ..do something
    }
}

错误信息 #

error[E0382]: use of moved value: workbook

错误原因 #

Rust的所有权规则：workbook是拥有所有权的值，第一次调用handle_sheet时，所有权会被转移到函数内部。第二次循环时，workbook已经被移动，无法再被使用，因此触发该错误。

解决方案 #

1. 传递可变引用（最优解） #

修改handle_sheet函数，让它接收workbook的可变引用，这样不会转移所有权，只是临时借用资源，循环中可以重复使用同一workbook。

修改后的代码：

use std::{fs::File, io::BufReader};
use calamine::{open_workbook_auto, DataType, Reader, Sheets};

pub fn read_to_workbook(filename: String) {
    let mut workbook = open_workbook_auto(filename).expect("Cannot open file");

    let sheets = workbook.sheet_names().to_owned();
    for sheet_name in &sheets {
        handle_sheet(sheet_name.to_string(), &mut workbook);
    }
}

fn handle_sheet(sheet_name: String, workbook: &mut Sheets<BufReader<File>>) {
    if let Some(Ok(range)) = workbook.worksheet_range(&sheet_name) {
        // ..do something
        println!("处理工作表: {}", sheet_name);
    }
}

这种方式效率最高，无需额外复制或IO操作，完全符合Rust的内存安全规则。

2. 克隆workbook（不推荐） #

如果业务场景特殊，可克隆workbook为每个循环创建新实例，但这会带来额外的内存和IO开销（每个克隆实例可能需要重新读取文件内容），仅适合小文件场景。

修改后的代码片段：

pub fn read_to_workbook(filename: String) {
    let workbook = open_workbook_auto(filename).expect("Cannot open file");

    let sheets = workbook.sheet_names().to_owned();
    for sheet_name in &sheets {
        let workbook_clone = workbook.clone();
        handle_sheet(sheet_name.to_string(), workbook_clone);
    }
}

3. 循环内重新打开workbook（不推荐） #

每次循环重新打开文件并创建workbook，虽然能解决所有权问题，但会重复执行IO操作，效率极低，仅在极端特殊场景下考虑。

修改后的代码片段：

pub fn read_to_workbook(filename: String) {
    let workbook = open_workbook_auto(filename.clone()).expect("Cannot open file");
    let sheets = workbook.sheet_names().to_owned();

    for sheet_name in &sheets {
        let workbook = open_workbook_auto(filename.clone()).expect("Cannot open file");
        handle_sheet(sheet_name.to_string(), workbook);
    }
}

总结 #

优先选择传递可变引用的方案，既高效又符合Rust的设计理念。

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