1. 产品
  2.   电子表格
  3.   Rust
  4.   umya-spreadsheet

umya-spreadsheet

 
 

用于 XLSX/XLSM 文件的纯 Rust 库

在零外部依赖下读取、写入、样式化和操作 XLSX/XLSM 电子表格。

什么是 umya-spreadsheet?

umya-spreadsheet 是一个高性能、纯 Rust 库,用于读取和写入 XLSX 和 XLSM 格式的 Excel 电子表格文件。它以安全性和效率为设计目标,避免使用不安全的代码和外部依赖,使其非常适合桌面应用、服务器端处理以及 WebAssembly 环境。该库提供了简洁、符合 Rust 习惯的 API,用于访问单元格、行、列、样式、图表和图像,使开发者能够构建强大的电子表格工具,而无需依赖 Microsoft Office 或 COM 互操作。

umya-spreadsheet 完全支持惰性加载、密码保护和丰富的格式设置,弥合了性能与易用性之间的差距。它支持 CSV 导出、图表生成、图像嵌入以及移动和复制等范围操作。该项目积极维护,文档完善,经过充分测试,注重正确性并兼容现代 Excel 功能。开发者可以使用 Tauri 或 Axo 等框架,将其集成到 CLI 工具、Web 后端或桌面应用中。

Previous Next

umya-spreadsheet 入门指南

要开始使用 umya-spreadsheet,请在 Cargo.toml 中添加 `umya-spreadsheet = "3.1.1"`。若需 WebAssembly 支持,请启用 `js` 功能。该库依赖轻量,编译快速。安装后,通过 `extern crate umya_spreadsheet;` 导入并开始读取或写入电子表格。您还可以访问 umya-spreadsheet GitHub 获取示例、测试和文档。它支持对大文件的惰性加载,并提供健壮的错误处理。

通过 Cargo 安装 umya-spreadsheet

[dependencies]
umya-spreadsheet = "3.1.1"

# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }

读取和写入 XLSX/XLSM 文件

umya-spreadsheet 提供直观的 API 用于读取和写入 XLSX 和 XLMS 文件。使用 `reader::xlsx::read()` 从磁盘加载工作簿,或使用 `new_file()` 创建一个空白工作簿。写入同样简单:调用 `writer::xlsx::write()` 并传入工作簿和目标路径。该库支持通过 `lazy_read()` 进行惰性加载,以提升大文件的性能,并且允许密码保护写入或在创建后设置密码。所有操作都是安全的,尽可能零拷贝,并且避免使用外部二进制文件。

如何使用 Rust 读取和写入 XLSX 文件?

use std::path::Path;

// Read file
let path = Path::new("./input.xlsx");
let mut book = umya_spreadsheet::reader::xlsx::read(path).unwrap();

// Write file
let out_path = Path::new("./output.xlsx");
umya_spreadsheet::writer::xlsx::write(&book, out_path).unwrap();

单元格访问与样式操作

访问和修改单元格值非常直接:使用 `cell("A1")` 或 `cell((1,1))` 进行读取,使用 `cell_mut()` 进行写入。样式通过 `style_mut()` 管理,支持背景颜色、字体、边框和对齐方式的更改。该库在尽可能保持不可变性的前提下,提供了丰富的样式属性。您还可以获取格式化的值、应用条件逻辑,并在范围内批量更新样式。这使其非常适合生成报告、仪表板或具有一致格式的数据导出。

如何通过 Rust 修改单元格的值和样式?

let mut book = umya_spreadsheet::new_file();
book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .cell_mut("A1")
    .set_value("Hello, Rust!");

let mut style = book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .style_mut("A1");
style.set_background_color(umya_spreadsheet::Color::COLOR_RED);

图表与图像支持

umua-spreadsheet 支持通过定义系列范围和标记来创建和编辑图表——包括折线图、柱状图和面积图。您可以使用 `Image` 结构体直接将图像嵌入工作表,支持 PNG 等格式,具体取决于启用的功能。图表和图像与单元格坐标及绘图层无缝集成,实现动态仪表板生成。虽然某些高级绘图功能仍在发展中,但核心功能已具备生产就绪性且可扩展。

如何通过 Rust 向电子表格添加折线图?

let mut book = umya_spreadsheet::new_file();
let mut from_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
from_marker.set_coordinate("C1");
let mut to_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
to_marker.set_coordinate("D11");
let series = vec!["Sheet1!$A$1:$A$10", "Sheet1!$B$1:$B$10"];
let mut chart = umya_spreadsheet::structs::Chart::default();
chart.new_chart(
    umya_spreadsheet::structs::ChartType::LineChart,
    from_marker,
    to_marker,
    series,
);
book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .add_chart(chart);

范围操作与密码保护

使用 `move_range()` 执行移动、复制和调整范围大小等高级操作,实现动态数据重组。该库还支持受密码保护的工作簿:可使用 `write_with_password()` 写入文件,或通过 `set_password()` 为已有文件设置密码。这些功能对于企业或合规敏感的应用中的安全数据处理至关重要。结合零依赖设计和 WASM 兼容性,umya-spreadsheet 提供了灵活性和安全性。

如何通过 Rust 移动范围并使用密码保护文件?

// Move range
let range = "A1:A3";
book.sheet_by_name_mut("Sheet1")
    .unwrap()
    .move_range(range, &10, &2);

// Password protection
umya_spreadsheet::writer::xlsx::write_with_password(
    &book,
    Path::new("./protected.xlsx"),
    "mypassword",
).unwrap();
 中国人