1. 产品
  2.   电子表格
  3.   Rust
  4.   rust_xlsxwriter

rust_xlsxwriter

 
 

用于 Excel XLSX 文件的开源 Rust 库

通过 Rust API 生成具有完整格式、图表、公式和图像的 Excel 2007+ XLSX 文件。

rust_xlsxwriter 是什么?

rust_xlsxwriter 是一个高性能、纯 Rust 的 crate,用于生成 Excel XLSX 文件,无需 Excel 或外部依赖。它使开发者能够以编程方式创建包含文本、数字、日期、公式、图表、图片、合并单元格、条件格式、数据验证等内容的电子表格。该库设计注重可靠性和速度,紧密匹配 Excel 的原生文件格式,并支持大数据集的常量内存模式。此库是对流行的 Python XlsxWriter 库的忠实 Rust 重写,提供惯用的 API 和全面的文档。

rust_xlsxwriter 专注于仅写入 Excel 文件——不读取或修改现有文件。它支持现代 Excel 功能,如动态数组、迷你图、复选框、文本框、表格、自动筛选、已定义名称和工作簿主题。通过可选功能,如 Serde 序列化、chrono/jiff 日期支持以及 Polars 集成,它能够适配多样的 Rust 生态系统。其性能仅次于 C 版本,执行速度比 Python 的 XlsxWriter 快 3.8 倍。欲了解完整细节,请参阅 rust_xlsxwriter GitHub 仓库。

Previous Next

rust_xlsxwriter 入门指南

rust_xlsxwriter 可在 crates.io 上获取,并可通过 `cargo add rust_xlsxwriter` 安装。若需增强功能,请启用可选特性,如 `constant_memory`、`chrono`、`serde` 或 `polars`。该库要求 Rust 1.56+,并编译为本机二进制文件,除默认的 `zip` crate 外,无其他外部运行时依赖。它提供完整的文档,包括用户指南、教程和配方手册。欲获取详细示例和源代码,请访问 rust_xlsxwriter GitHub 仓库。

通过 Cargo 安装 rust_xlsxwriter

cargo add rust_xlsxwriter

使用文本、数字和日期编写格式化单元格

rust_xlsxwriter 提供了一个简洁直观的 API,用于向 Excel 单元格写入格式化内容。开发者可以使用 `Format` 结构体为数字、日期、字体、边框、对齐方式和颜色等应用自定义格式。该库支持写入纯文本、数值、日期、公式和带可选格式的 URL。它还支持在单个单元格内进行混合格式的富多格式字符串。这使其非常适合生成报告、仪表板和数据导出,在视觉清晰度和结构性至关重要的场景中表现出色。API 确保与 Excel 本机格式引擎的高度一致性。

如何使用 Rust 编写格式化的文本、数字和日期?

use rust_xlsxwriter::*;

let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();

let bold = Format::new().set_bold();
let decimal = Format::new().set_num_format("0.00");
let date_fmt = Format::new().set_num_format("yyyy-mm-dd");

worksheet.write_with_format(0, 0, "Hello", &bold)?;
worksheet.write(1, 0, 123.456)?;
worksheet.write_with_format(2, 0, 789.012, &decimal)?;
let date = ExcelDateTime::from_ymd(2023, 12, 25)?;
worksheet.write_with_format(3, 0, &date, &date_fmt)?;
workbook.save("formatted.xlsx")?;

创建图表、迷你图和图像

rust_xlsxwriter 支持在 Excel 文件中直接生成专业图表、迷你图(sparklines)和嵌入图像。开发者可以创建柱状图、折线图、饼图、散点图和面积图,并自定义坐标轴、图例和数据系列。迷你图在单元格内提供紧凑的趋势可视化。图像(PNG、JPEG、GIF、BMP)可以插入并通过缩放和锚定选项进行定位。这些可视化元素提升了数据叙事和报告能力。该库确保兼容 Excel 2007 及以上版本,并在各平台保持渲染保真度。

如何通过 Rust 向 Excel 添加图表和图片?

use rust_xlsxwriter::*;

let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();

// Write sample data
for i in 0..5 {
    worksheet.write_number(i, 0, (i + 1) as f64 * 10.0)?;
}

// Create a chart
let mut chart = Chart::new(ChartType::Column);
chart.add_series().set_values("Sheet1!$A$1:$A$5");
worksheet.insert_chart(0, 2, &chart)?;

// Insert an image
let image = Image::new("logo.png")?;
worksheet.insert_image(5, 2, &image)?;

workbook.save("chart_image.xlsx")?;

高级格式化:合并单元格、表格和条件格式

rust_xlsxwriter 提供高级 Excel 格式化功能,如合并区域、结构化表格、自动筛选和条件格式规则。开发者可以合并单元格用于标题或标签,应用带有交错行/列的表格样式,并定义筛选器以实现用户交互。条件格式支持颜色刻度、数据条、图标集以及自定义公式,用于突出显示趋势或异常。这些功能提升了生成工作簿的数据可读性和交互性。API 将复杂的 XML 结构抽象为直观的 Rust 方法,确保可维护性和类型安全。

如何合并单元格并使用条件格式添加表格?

use rust_xlsxwriter::*;

let mut workbook = Workbook::new();
let worksheet = workbook.add_worksheet();

// Merge cells
let merge_fmt = Format::new()
    .set_border(FormatBorder::Thin)
    .set_align(FormatAlign::Center);
worksheet.merge_range(0, 0, 0, 2, "Report Header", &merge_fmt)?;

// Add table
worksheet.add_table(1, 0, 5, 2, Table::new().set_columns(&[
    ("Item", None),
    ("Value", None),
    ("Status", None),
]))?;

// Conditional formatting
worksheet.conditional_format(
    2, 0, 5, 2,
    ConditionalFormat::new()
        .set_type(ConditionalFormatType::Cell)
        .set_format(&Format::new().set_bg_color("#D8E4BC"))
        .set_formula("=A2>100")
)?;

workbook.save("advanced.xlsx")?;

性能优化与大文件支持

rust_xlsxwriter 针对速度和内存效率进行了优化,尤其适用于大数据集。它支持常量内存模式(`constant_memory` 功能),该模式将数据增量写入磁盘,最小化堆内存使用。此模式非常适合生成多兆字节的 Excel 文件而不会出现 OOM 错误。基准测试显示,它的运行速度约比 Python 的 XlsxWriter 快 3.8 倍,仅比原生 C 库慢约 14%。可选的 `zmij` 和 `zlib` 功能进一步加速数值写入和压缩。这些能力使其适用于批量报告、ETL 流程以及服务器端的 Excel 生成。

如何为大型文件启用常量内存模式?

cargo add rust_xlsxwriter -F constant_memory
use rust_xlsxwriter::*;

let mut workbook = Workbook::new();
workbook.set_constant_memory(true); // Enable constant memory mode

let worksheet = workbook.add_worksheet();
for i in 0..100_000 {
    worksheet.write_number(i, 0, i as f64)?;
}

workbook.save("large_file.xlsx")?;
 中国人