rust_xlsxwriter

 
 

Библиотека с отворен код за Rust за Excel XLSX файлове

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

Какво е rust_xlsxwriter?

rust_xlsxwriter е високопроизводителен, чист Rust crate за генериране на Excel XLSX файлове без необходимост от Excel или външни зависимости. Той позволява на разработчиците програмено създаване на електронни таблици с текст, числа, дати, формули, диаграми, изображения, обединени клетки, условно форматиране, проверка на данни и др. Проектиран за надеждност и скорост, той точно съвпада с оригиналния файлов формат на Excel и поддържа режим на постоянна памет за големи набори от данни. Библиотеката е вярно Rust пренаписване на популярната Python XlsxWriter библиотека, с идиоматични API‑та и обширна документация.

rust_xlsxwriter се фокусира изключително върху записването на Excel файлове — без четене или модификация на съществуващи файлове. Той поддържа модерни функции на Excel като динамични масиви, спарклайни, отметки, текстови полета, таблици, автоматични филтри, дефинирани имена и теми на работната книга. С опционални функции като Serde сериализация, поддръжка на дати chrono/jiff и интеграция с Polars, той се адаптира към разнообразни Rust екосистеми. Производителността му е второ след C версията, осигурявайки 3.8× по-бързо изпълнение от Python XlsxWriter. За пълни детайли, вижте rust_xlsxwriter GitHub хранилище.

Previous Next

Започване с rust_xlsxwriter

rust_xlsxwriter е достъпен в crates.io и може да се инсталира чрез `cargo add rust_xlsxwriter`. За разширена функционалност, активирайте опционалните функции като `constant_memory`, `chrono`, `serde` или `polars`. Библиотеката изисква Rust 1.56+ и се компилира до native бинарни файлове без външни runtime зависимости, освен `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` функция), който записва данните инкрементно на диска, като минимизира използването на купчината. Този режим е идеален за генериране на многомеґабайтни Excel файлове без OOM грешки. Тестовете показват, че работи около ~3.8× по-бързо от Python‑овия XlsxWriter и само ~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")?;
 Български