
rust_xlsxwriter
ไลบรารี Rust โอเพนซอร์สสำหรับไฟล์ Excel XLSX
สร้างไฟล์ Excel 2007+ XLSX พร้อมการจัดรูปแบบเต็ม, แผนภูมิ, สูตรและรูปภาพผ่าน Rust API.
rust_xlsxwriter คืออะไร?
rust_xlsxwriter เป็น crate Rust แท้ที่มีประสิทธิภาพสูงสำหรับการสร้างไฟล์ Excel XLSX โดยไม่ต้องใช้ Excel หรือการพึ่งพาภายนอก มันทำให้ผู้พัฒนาสามารถสร้างสเปรดชีตโดยโปรแกรมได้ด้วยข้อความ ตัวเลข วันที่ สูตร แผนภูมิ รูปภาพ เซลล์ที่รวมกัน การจัดรูปแบบตามเงื่อนไข การตรวจสอบความถูกต้องของข้อมูล และอื่น ๆ ออกแบบเพื่อความน่าเชื่อถือและความเร็ว โดยตรงกับรูปแบบไฟล์ดั้งเดิมของ Excel และรองรับโหมดหน่วยความจำคงที่สำหรับชุดข้อมูลขนาดใหญ่ ไลบรารีนี้เป็นการเขียนใหม่ด้วย Rust อย่างแท้จริงของไลบรารี Python XlsxWriter ที่ได้รับความนิยม พร้อม API ที่เป็นธรรมชาติและเอกสารที่ครอบคลุม
rust_xlsxwriter มุ่งเน้นเฉพาะการเขียนไฟล์ Excel — ไม่รองรับการอ่านหรือแก้ไขไฟล์ที่มีอยู่แล้ว มันสนับสนุนคุณลักษณะสมัยใหม่ของ Excel เช่น อาเรย์แบบไดนามิก, สปาร์คลไลน์, กล่องทำเครื่องหมาย, กล่องข้อความ, ตาราง, ตัวกรองอัตโนมัติ, ชื่อที่กำหนด, และธีมของเวิร์กบุ๊ก ด้วยคุณลักษณะเสริมเช่น การทำซีเรียลไลซ์ด้วย Serde, การสนับสนุนวันที่ chrono/jiff, และการบูรณาการกับ Polars, มันปรับตัวให้เข้ากับระบบนิเวศ Rust ที่หลากหลาย ประสิทธิภาพของมันอยู่รองจากเวอร์ชัน C เท่านั้น โดยให้ความเร็วการทำงานเร็วกว่า XlsxWriter ของ Python ถึง 3.8 เท่า สำหรับรายละเอียดเต็ม ๆ ดูที่ ที่เก็บ rust_xlsxwriter บน GitHub.
เริ่มต้นใช้งาน rust_xlsxwriter
rust_xlsxwriter มีให้ใช้งานบน crates.io และสามารถติดตั้งได้ผ่าน `cargo add rust_xlsxwriter`. สำหรับการทำงานที่เพิ่มขึ้น ให้เปิดใช้งานฟีเจอร์เสริมเช่น `constant_memory`, `chrono`, `serde`, หรือ `polars`. ไลบรารีต้องการ Rust 1.56+ และคอมไพล์เป็นไบนารีเนทีฟโดยไม่มีการพึ่งพา runtime ภายนอกนอกจาก crate `zip` (โดยค่าเริ่มต้น). มีเอกสารครบถ้วนรวมถึงคู่มือผู้ใช้, บทแนะนำ, และสูตรอาหาร. สำหรับตัวอย่างโดยละเอียดและซอร์สโค้ด, เยี่ยมชม ที่เก็บ GitHub ของ rust_xlsxwriter.
ติดตั้ง 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 รองรับการสร้างแผนภูมิเพียรระดับมืออาชีพ, sparklines, และการฝังรูปภาพโดยตรงลงในไฟล์ Excel. นักพัฒนาสามารถสร้างแผนภูมิแท่ง, เส้น, พาย, กระจาย, และพื้นที่พร้อมแกน, คำอธิบาย, และชุดข้อมูลที่ปรับแต่งได้. Sparklines ให้การแสดงแนวโน้มแบบกะทัดรัดภายในเซลล์. รูปภาพ (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) ซึ่งจะเขียนข้อมูลลงดิสก์อย่างต่อเนื่อง เพื่อลดการใช้ heap โหมดนี้เหมาะสำหรับการสร้างไฟล์ Excel ขนาดหลายเมกะไบต์โดยไม่เกิดข้อผิดพลาด OOM การทดสอบแสดงว่ามันทำงานเร็วประมาณ ~3.8× มากกว่า XlsxWriter ของ Python และช้ากว่าไลบรารี C ดั้งเดิมเพียง ~14% ฟีเจอร์เสริมเช่น `zmij` และ `zlib` ช่วยเร่งการเขียนตัวเลขและการบีบอัด ความสามารถเหล่านี้ทำให้เหมาะสำหรับการรายงานแบบแบตช์, pipeline ETL, และการสร้าง Excel ฝั่งเซิร์ฟเวอร์
วิธีเปิดใช้งานโหมดหน่วยความจำคงที่สำหรับไฟล์ขนาดใหญ่?
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")?;