
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 仓库。
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_memoryuse 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")?;