1. Produk
  2.   Hamparan
  3.   Rust
  4.   rust_xlsxwriter

rust_xlsxwriter

 
 

Perpustakaan Rust Sumber Terbuka untuk Fail Excel XLSX

Jana Fail XLSX Excel 2007+ dengan Pemformatan Penuh, Carta, Formula & Imej melalui API Rust.

Apakah rust_xlsxwriter?

rust_xlsxwriter ialah sebuah crate Rust tulen berprestasi tinggi untuk menjana fail Excel XLSX tanpa memerlukan Excel atau kebergantungan luaran. Ia membolehkan pembangun mencipta hamparan kerja secara programatik dengan teks, nombor, tarikh, formula, carta, imej, sel yang digabungkan, pemformatan bersyarat, pengesahan data, dan banyak lagi. Direka untuk kebolehpercayaan dan kelajuan, ia hampir serupa dengan format fail asli Excel dan menyokong mod memori berterusan untuk set data yang besar. Perpustakaan ini merupakan penulisan semula Rust yang setia kepada perpustakaan Python XlsxWriter yang popular, dengan API idiomatik dan dokumentasi yang komprehensif.

rust_xlsxwriter memberi tumpuan secara eksklusif kepada penulisan fail Excel—tiada pembacaan atau pengubahsuaian fail sedia ada. Ia menyokong ciri-ciri Excel moden seperti tatasusunan dinamik, sparkline, kotak semak, kotak teks, jadual, penapis automatik, nama yang ditakrifkan, dan tema buku kerja. Dengan ciri pilihan seperti penserialan Serde, sokongan tarikh chrono/jiff, dan integrasi Polars, ia menyesuaikan diri dengan ekosistem Rust yang pelbagai. Prestasinya berada di belakang versi C sahaja, memberikan kelajuan pelaksanaan 3.8× lebih pantas berbanding XlsxWriter Python. Untuk butiran penuh, lihat repositori rust_xlsxwriter di GitHub.

Previous Next

Mula Menggunakan rust_xlsxwriter

rust_xlsxwriter tersedia di crates.io dan boleh dipasang melalui `cargo add rust_xlsxwriter`. Untuk fungsi tambahan, aktifkan ciri pilihan seperti `constant_memory`, `chrono`, `serde`, atau `polars`. Pustaka ini memerlukan Rust 1.56+ dan menyusun ke binari asli tanpa kebergantungan runtime luaran selain crate `zip` (secara lalai). Ia didokumentasikan sepenuhnya dengan panduan pengguna, tutorial, dan buku masak. Untuk contoh terperinci dan kod sumber, lawati repositori GitHub rust_xlsxwriter.

Pasang rust_xlsxwriter melalui Cargo

cargo add rust_xlsxwriter

Tulis Sel Berformat dengan Teks, Nombor & Tarikh

rust_xlsxwriter menyediakan API yang mudah dan intuitif untuk menulis kandungan berformat ke sel Excel. Pembangun boleh menggunakan format tersuai untuk nombor, tarikh, fon, sempadan, penjajaran, dan warna menggunakan struktur `Format`. Pustaka ini menyokong penulisan teks biasa, nilai numerik, tarikh, formula, dan URL dengan format pilihan. Ia juga menyokong rentetan berbilang format yang kaya untuk pemformatan campuran dalam satu sel. Ini menjadikannya ideal untuk menjana laporan, papan pemuka, dan eksport data di mana kejelasan visual dan struktur sangat penting. API memastikan kesetiaan tinggi dengan enjin pemformatan asli Excel.

Bagaimana Menulis Teks, Nombor & Tarikh Berformat melalui 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")?;

Cipta Carta, Sparkline & Imej

rust_xlsxwriter menyokong penjanaan carta profesional, sparkline, dan penyisipan imej secara langsung ke dalam fail Excel. Pembangun boleh mencipta carta bar, garis, pai, serakan, dan kawasan dengan paksi, legenda, dan siri data yang boleh disesuaikan. Sparkline menyediakan visualisasi trend yang padat dalam sel. Imej (PNG, JPEG, GIF, BMP) boleh dimasukkan dan diletakkan dengan pilihan penskalaan dan penambatan. Elemen visual ini meningkatkan penceritaan data dan keupayaan pelaporan. Perpustakaan ini memastikan keserasian dengan Excel 2007+ dan mengekalkan ketepatan rendering merentasi platform.

Bagaimana Menambah Carta & Imej ke Excel melalui 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")?;

Pemformatan Lanjutan: Sel Gabungan, Jadual & Pemformatan Bersyarat

rust_xlsxwriter membolehkan ciri pemformatan Excel lanjutan seperti julat yang digabungkan, jadual berstruktur, autofilter, dan peraturan pemformatan bersyarat. Pembangun boleh menggabungkan sel untuk tajuk atau label, menerapkan gaya jadual dengan baris/kolum berjalur, dan menentukan penapis untuk interaktiviti pengguna. Pemformatan bersyarat menyokong skala warna, bar data, set ikon, dan formula tersuai untuk menyorot trend atau anomali. Ciri-ciri ini meningkatkan kebolehbacaan data dan interaktiviti dalam buku kerja yang dijana. API mengabstrakkan struktur XML yang kompleks menjadi kaedah Rust yang intuitif, memastikan kebolehselenggaraan dan keselamatan jenis.

Bagaimana Menggabungkan Sel & Menambah Jadual dengan Pemformatan Bersyarat?

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")?;

Pengoptimuman Prestasi & Sokongan Fail Besar

rust_xlsxwriter dioptimumkan untuk kelajuan dan kecekapan memori, terutamanya untuk set data besar. Ia menyokong mod memori berterusan (`constant_memory` feature), yang menulis data secara berperingkat ke cakera, meminimumkan penggunaan heap. Mod ini ideal untuk menjana fail Excel berukuran bermegabait tanpa ralat OOM. Penanda aras menunjukkan ia berjalan ~3.8× lebih pantas daripada XlsxWriter Python dan hanya ~14% lebih perlahan daripada perpustakaan C asli. Ciri pilihan seperti `zmij` dan `zlib` lebih mempercepat penulisan numerik dan pemampatan. Keupayaan ini menjadikannya sesuai untuk pelaporan kumpulan, saluran ETL, dan penjanaan Excel sisi pelayan.

Bagaimana Mengaktifkan Mod Memori Berterusan untuk Fail Besar?

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")?;
 Melayu