Aspose.Cells FOSS
常见问题

常见问题

许可与开源

Aspose.Cells FOSS for Rust 使用什么许可证？

该 crate 在 MIT 许可证下发布。完整文本作为 LICENSE.txt 随仓库一起提供。

我可以在商业产品中使用它吗？

是的。MIT 许可证允许商业使用、修改和再分发。唯一的要求是保留软件副本或重要部分中的版权和许可证声明。

安装与要求

我该如何安装该 crate？

将 aspose-cells-foss-rust 添加到你的 Cargo.toml 中，作为 git 依赖：

# Cargo.toml
[dependencies]
aspose-cells-foss-rust = { git = "https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Rust" }

请参阅 安装指南 以获取逐步演练。

支持哪些 Rust 版本？

该 crate 目标 Rust 2021 版。

它是否需要 Microsoft Office 或本机库？

不。该库直接读取和写入 XLSX 包格式——不需要 Microsoft Office 安装、COM 自动化或外部运行时。

格式支持

哪些格式可以读取和写入？

XLSX 是当前版本支持的格式：完整的往返读取和写入。加载通过 Workbook::load_xlsx（LoadFormat 枚举覆盖 Auto 和 Xlsx），保存则通过 save、save_xlsx 或 save_with_format，并使用 SaveFormat 枚举。

它能修复损坏的 XLSX 文件吗？

LoadOptions 暴露了 try_repair_package 和 try_repair_xml 标志，且 LoadDiagnostics 报告加载过程中遇到的问题：

let options = LoadOptions {
    try_repair_package: true,
    try_repair_xml: true,
    ..LoadOptions::default()
};
let loaded = Workbook::load_xlsx_with_options(&path, &options)?;

API Usage

创建工作簿的典型模式是什么？

创建一个 Workbook，限定可变借用的作用域，写入数值，然后保存：

let mut workbook = Workbook::new();
{
    let mut worksheets = workbook.get_worksheets_mut();
    let sheet = worksheets.get(0)?;
    let mut cells = sheet.get_cells_mut();
    cells.get("A1")?.put_value_string("Hello")?;
}
workbook.save("hello.xlsx")?;

我该如何向单元格写入不同类型的值？

在可变单元格上使用类型化的 setter：put_value_string、put_value_i32、put_value_bool、put_value_decimal和put_value_date_time。

我该如何编写公式？

使用 put_formula_with_cached_value，提供 Excel 在首次重新计算之前应显示的值：

cells.get("G1")?
    .put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;

我该如何从已加载的工作簿中读取数值？

使用 worksheet（或工作表集合）获取工作表，然后通过 get_cells 读取单元格；display_string_value 返回显示文本，value_type 报告存储的类型。

已知限制

该 crate 在 crates.io 上吗？

尚未发布 — 请从 GitHub 仓库将其作为 Cargo git 依赖安装。Cargo 会在 Cargo.lock 中记录确切的提交，从而保证构建可复现。

是否支持除 XLSX 之外的其他格式？

不。当前版本专注于 XLSX 的往返处理；其他电子表格格式既不读取也不写入。

另请参阅

 中文