rust_xlsxwriter

 
 

Библиотека Rust с открытым исходным кодом для файлов Excel XLSX

Создавайте файлы Excel 2007+ XLSX с полным форматированием, диаграммами, формулами и изображениями через API Rust.

Что такое rust_xlsxwriter?

rust_xlsxwriter — это высокопроизводительный, чистый crate на Rust для создания файлов Excel XLSX без необходимости установки Excel или внешних зависимостей. Он позволяет разработчикам программно создавать электронные таблицы с текстом, числами, датами, формулами, диаграммами, изображениями, объединёнными ячейками, условным форматированием, проверкой данных и многим другим. Разработан для надёжности и скорости, он точно соответствует нативному формату файлов Excel и поддерживает режим постоянной памяти для больших наборов данных. Библиотека представляет собой точный порт на Rust популярной библиотеки Python XlsxWriter, с идиоматичными API и полной документацией.

rust_xlsxwriter ориентирован исключительно на запись файлов Excel — чтение или изменение существующих файлов не поддерживается. Он поддерживает современные возможности Excel, такие как динамические массивы, спарклайны, флажки, текстовые поля, таблицы, автофильтры, определённые имена и темы книги. С дополнительными функциями, такими как сериализация Serde, поддержка дат chrono/jiff и интеграция с Polars, он адаптируется к различным экосистемам Rust. Его производительность уступает только C‑версии, обеспечивая в 3,8 × более быстрое выполнение, чем XlsxWriter на Python. Для получения полной информации см. репозиторий rust_xlsxwriter на GitHub.

Previous Next

Начало работы с rust_xlsxwriter

rust_xlsxwriter доступен на crates.io и может быть установлен с помощью `cargo add rust_xlsxwriter`. Для расширенной функциональности включите необязательные функции, такие как `constant_memory`, `chrono`, `serde` или `polars`. Библиотека требует Rust 1.56+ и компилируется в нативные бинарные файлы без внешних зависимостей времени выполнения, кроме crate `zip` (по умолчанию). Она полностью документирована с руководством пользователя, учебником и кулинарной книгой. Для подробных примеров и исходного кода посетите репозиторий rust_xlsxwriter на GitHub.

Установите rust_xlsxwriter через Cargo

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. Разработчики могут создавать столбчатые, линейные, круговые, точечные и областные диаграммы с настраиваемыми осями, легендами и сериями данных. Спарклайны предоставляют компактную визуализацию тенденций внутри ячеек. Изображения (PNG, JPEG, GIF, BMP) можно вставлять и позиционировать с параметрами масштабирования и привязки. Эти визуальные элементы улучшают повествование данных и возможности отчетности. Библиотека обеспечивает совместимость с Excel 2007+ и сохраняет точность отображения на разных платформах.

Как добавить диаграмму и изображение в Excel с помощью Rust?

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` feature), который записывает данные постепенно на диск, минимизируя использование кучи. Этот режим идеален для создания многомегабайтных Excel‑файлов без ошибок OOM. Тесты показывают, что он работает примерно в ~3.8× быстрее, чем XlsxWriter на Python, и лишь на ~14% медленнее, чем нативная библиотека на C. Дополнительные возможности, такие как `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")?;
 Русский