
xlsxwriter-rs
用于生成 Excel XLSX 的 Rust 库
通过 Rust API 创建完全兼容的 Excel XLSX 文件,支持格式化、合并单元格、自动筛选和图像。
xlsxwriter-rs 是什么?
xlsxwriter-rs 是一个高性能的 Rust 绑定,针对广泛使用的 libxlsxwriter C 库,使开发者能够直接从 Rust 应用程序生成完全兼容的 Excel XLSX 文件。它支持全面的 Excel 格式设置,包括字体、颜色、对齐、边框和数字格式,以及合并单元格、自动筛选、数据验证和嵌入的 PNG/JPEG 图像等高级功能。凭借可靠性和速度,xlsxwriter-rs 非常适合服务器端报表生成、数据导出流水线以及任何需要在 Rust 中以编程方式创建 Excel 文件的场景。
该库利用 Rust 的内存安全性和零成本抽象,提供一个安全高效的 Excel 生成 API,无需 Microsoft Excel 或诸如 COM 的外部依赖。它与 Cargo 无缝集成,并支持可选的功能标志来自定义行为,例如禁用 MD5 校验或使用系统 zlib。凭借其简洁、符合 Rust 习惯的接口和完整的文档,xlsxwriter-rs 使开发者能够构建强大、跨平台的 Excel 生成工具,同时对文件结构和内容保持完全控制。
开始使用 xlsxwriter-rs
要开始使用 xlsxwriter-rs,请通过 cargo add xlsxwriter 将其添加到您的 Cargo.toml,或手动在 [dependencies] 中加入 xlsxwriter = "0.1"。该库在 bindgen 编译时需要 LLVM 和 Clang。对于 Windows,安装 Visual Studio 和 LLVM,然后将 LIBCLANG_PATH 设置为 LLVM 的 bin 目录。设置完成后,克隆仓库,运行 git submodule update --init --recursive 以获取 C 库,并使用 cargo run --example hello_spreadsheet 构建示例。完整的文档和示例可在 xlsxwriter-rs GitHub 上获取。
通过 Cargo 安装 xlsxwriter-rs
cargo add xlsxwriter完整的 Excel 格式化支持
xlsxwriter-rs 提供了全面的格式化功能,允许开发者自定义字体、颜色、边框、对齐方式和数字格式,适用于单元格或范围。您可以对文本应用粗体、斜体、下划线、字号和自定义颜色,设置背景填充颜色,使用各种样式(细、常规、粗)定义单元格边框,并控制水平/垂直对齐。此级别的控制确保生成的 Excel 文件符合专业报告标准。格式化是通过 Format 结构体应用的,该结构体支持方法链式调用,以实现直观的配置。此功能对于创建视觉上区分度高的报告、仪表板和数据导出非常重要,可提升可读性和用户体验。
为单元格应用字体颜色和对齐方式
let mut sheet1 = workbook.add_worksheet(None)?;
sheet1.write_string(
0, 0,
"Red text",
Some(&Format::new().set_font_color(FormatColor::Red))
)?;
sheet1.write_string(
2, 0,
"Centered green text",
Some(&Format::new()
.set_font_color(FormatColor::Green)
.set_align(FormatAlignment::CenterAcross)
.set_vertical_align(FormatVerticalAlignment::VerticalCenter)
)
)?;合并单元格和范围
该库支持合并矩形单元格范围,这对于在 Excel 报表中创建标题、标题行和分组数据段至关重要。使用 merge_range 方法,您可以跨越多行多列,同时对整个合并块应用格式设置。这确保了在复杂电子表格中的样式和布局保持一致。合并的单元格完全兼容 Excel 的渲染引擎,并保留诸如文本对齐、边框和背景颜色等格式。此功能特别适用于财务报表、仪表板和表单,在这些场景中,视觉分组可提升数据理解和呈现质量。
合并具有自定义格式的范围
sheet1.merge_range(
2, 0,
3, 2,
"Hello, world",
Some(&Format::new()
.set_font_color(FormatColor::Green)
.set_align(FormatAlignment::CenterAcross)
.set_vertical_align(FormatVerticalAlignment::VerticalCenter)
)
)?;自动筛选和数据验证
xlsxwriter-rs 使得可以以编程方式创建自动筛选和数据验证规则,允许用户直接在 Excel 中对数据进行排序、筛选和验证。您可以使用 set_autofilter 将自动筛选应用于单元格范围,并通过数据验证为用户输入定义下拉列表。这支持基于列表的验证、数值范围、日期以及自定义公式。这些功能提升了电子表格的交互性和数据完整性,使其适用于表单、模板和协作式数据录入。生成的 XLSX 文件在 Excel、LibreOffice 或 Google Sheets 中打开时保持完整功能,确保广泛的兼容性。
应用自动筛选和数据验证
// Apply autofilter to A1:C10
sheet1.set_autofilter("A1:C10")?;
// Add data validation (drop-down list) in B2
sheet1.data_validation(
"B2",
DataValidation::new_list(&["Option1", "Option2", "Option3"])
)?;嵌入图片和超链接
您可以使用 xlsxwriter-rs 将 PNG 和 JPEG 图像直接嵌入 Excel 工作表,支持定位、大小调整和缩放。这非常适合在报告中添加徽标、图表或可视化指示器。此外,该库支持超链接和 URL,并提供可自定义的格式(例如蓝色文本和下划线),实现对网站、文档或其他工作表的可点击链接。这些功能使 xlsxwriter-rs 适用于创建丰富的交互式报告和仪表板,结合数据、可视化和导航。所有嵌入的内容完全兼容 Excel 的渲染引擎,并在各平台上保持布局完整性。
写入 URL 并嵌入图像
// Write a clickable URL
sheet1.write_url(
1, 1,
"https://github.com/informationsea/xlsxwriter-rs",
Some(&Format::new()
.set_font_color(FormatColor::Blue)
.set_underline(FormatUnderline::Single)
)
)?;
// Embed an image (requires image path)
// sheet1.insert_image(5, 0, "logo.png")?;