
rust_xlsxwriter
Öppen källkod Rust-bibliotek för Excel XLSX-filer
Generera Excel 2007+ XLSX-filer med full formatering, diagram, formler och bilder via Rust‑API.
Vad är rust_xlsxwriter?
rust_xlsxwriter är ett högpresterande, rent Rust-paket för att generera Excel XLSX-filer utan att kräva Excel eller externa beroenden. Det gör det möjligt för utvecklare att programatiskt skapa kalkylblad med text, siffror, datum, formler, diagram, bilder, sammanslagna celler, villkorsstyrd formatering, datavalidering och mer. Designat för pålitlighet och hastighet, matchar det nära Excels inbyggda filformat och stöder konstant minnesläge för stora datamängder. Biblioteket är en trogen Rust-omskrivning av det populära Python XlsxWriter-biblioteket, med idiomatiska API:er och omfattande dokumentation.
rust_xlsxwriter fokuserar uteslutande på att skriva Excel-filer—ingen läsning eller modifiering av befintliga filer. Det stödjer moderna Excel-funktioner som dynamiska arrayer, sparklines, kryssrutor, textrutor, tabeller, autofilter, definierade namn och arbetsboksteman. Med valfria funktioner som Serde-serialisering, chrono/jiff-datumsstöd och Polars-integration anpassar det sig till olika Rust-ekosystem. Dess prestanda är näst bäst efter C-versionen och levererar 3,8× snabbare körning än Pythons XlsxWriter. För fullständig information, se rust_xlsxwriter GitHub‑arkiv.
Komma igång med rust_xlsxwriter
rust_xlsxwriter är tillgänglig på crates.io och kan installeras via `cargo add rust_xlsxwriter`. För förbättrad funktionalitet, aktivera valfria funktioner som `constant_memory`, `chrono`, `serde` eller `polars`. Biblioteket kräver Rust 1.56+ och kompileras till inhemska binärer utan externa körningsberoenden utöver `zip`-paketet (som standard). Det är fullt dokumenterat med en användarguide, handledning och kokbok. För detaljerade exempel och källkod, besök rust_xlsxwriter GitHub‑arkivet.
Installera rust_xlsxwriter via Cargo
cargo add rust_xlsxwriterSkriv formaterade celler med text, tal och datum
rust_xlsxwriter tillhandahåller ett enkelt och intuitivt API för att skriva formaterat innehåll till Excel‑celler. Utvecklare kan tillämpa anpassade format för tal, datum, typsnitt, kanter, justering och färger med hjälp av `Format`‑strukturen. Biblioteket stödjer att skriva ren text, numeriska värden, datum, formler och URL:er med valfri formatering. Det stödjer också rika multi‑formatsträngar för blandad formatering inom en enda cell. Detta gör det idealiskt för att generera rapporter, instrumentpaneler och dataexport där visuell klarhet och struktur är avgörande. API‑et säkerställer hög noggrannhet med Excels inbyggda formateringsmotor.
Hur skriver man formaterad text, tal och datum med 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")?;Skapa diagram, sparkline-grafer och bilder
rust_xlsxwriter stödjer generering av professionella diagram, sparkline-grafer och inbäddning av bilder direkt i Excel-filer. Utvecklare kan skapa stapel-, linje-, cirkel-, spridnings- och områdesdiagram med anpassningsbara axlar, legender och dataserier. Sparkline-grafer ger kompakt trendvisualisering inom celler. Bilder (PNG, JPEG, GIF, BMP) kan infogas och placeras med skalnings- och förankringsalternativ. Dessa visuella element förbättrar databerättande och rapporteringsmöjligheter. Biblioteket säkerställer kompatibilitet med Excel 2007+ och bevarar återgivningsnoggrannhet över plattformar.
Hur lägger du till ett diagram och en bild i Excel via 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")?;Avancerad formatering: sammanslagna celler, tabeller och villkorsstyrd formatering
rust_xlsxwriter möjliggör avancerade Excel-formateringsfunktioner såsom sammanslagna områden, strukturerade tabeller, autofilter och villkorsstyrda formateringsregler. Utvecklare kan slå ihop celler för rubriker eller etiketter, tillämpa tabellstilar med bandade rader/kolumner och definiera filter för användarinteraktivitet. Villkorsstyrd formatering stöder färgskalor, datastaplar, ikonsatser och anpassade formler för att markera trender eller avvikelser. Dessa funktioner förbättrar dataläsbarhet och interaktivitet i genererade arbetsböcker. API:et abstraherar komplexa XML-strukturer till intuitiva Rust-metoder, vilket säkerställer underhållbarhet och typ‑säkerhet.
Hur slår du samman celler och lägger till tabeller med villkorsstyrd formatering?
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")?;Prestandaoptimering och stöd för stora filer
rust_xlsxwriter är optimerat för hastighet och minneseffektivitet, särskilt för stora dataset. Det stöder konstant minnesläge (`constant_memory`-funktionen), som skriver data inkrementellt till disk och minimerar heap-användning. Detta läge är idealiskt för att generera Excel-filer på flera megabyte utan OOM‑fel. Prestandatester visar att det kör ~3.8× snabbare än Pythons XlsxWriter och bara ~14% långsammare än det inbyggda C‑biblioteket. Valfria funktioner som `zmij` och `zlib` påskyndar ytterligare numeriska skrivningar och komprimering. Dessa möjligheter gör det lämpligt för batchrapportering, ETL‑pipelines och server‑sidig Excel‑generering.
Hur aktiverar du konstant minnesläge för stora filer?
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")?;