
rust_xlsxwriter
Thư viện Rust mã nguồn mở cho tệp Excel XLSX
Tạo tệp Excel 2007+ XLSX với Định dạng đầy đủ, Biểu đồ, Công thức & Hình ảnh qua API Rust.
rust_xlsxwriter là gì?
rust_xlsxwriter là một crate Rust thuần, hiệu năng cao dùng để tạo các tệp Excel XLSX mà không cần Excel hay các phụ thuộc bên ngoài. Nó cho phép các nhà phát triển tạo bảng tính một cách lập trình với văn bản, số, ngày tháng, công thức, biểu đồ, hình ảnh, ô được gộp, định dạng có điều kiện, xác thực dữ liệu và nhiều hơn nữa. Được thiết kế để đáng tin cậy và nhanh chóng, nó gần giống với định dạng tệp gốc của Excel và hỗ trợ chế độ bộ nhớ cố định cho các bộ dữ liệu lớn. Thư viện này là bản chuyển thể Rust trung thực của thư viện Python XlsxWriter nổi tiếng, với các API mang tính idiomatic và tài liệu đầy đủ.
rust_xlsxwriter tập trung duy nhất vào việc ghi các tệp Excel—không đọc hoặc sửa đổi các tệp hiện có. Nó hỗ trợ các tính năng hiện đại của Excel như mảng động, sparklines, hộp kiểm, hộp văn bản, bảng, bộ lọc tự động, tên đã định nghĩa và chủ đề sổ làm việc. Với các tính năng tùy chọn như tuần tự hoá Serde, hỗ trợ ngày chrono/jiff, và tích hợp Polars, nó thích nghi với các hệ sinh thái Rust đa dạng. Hiệu năng của nó chỉ đứng sau phiên bản C, mang lại tốc độ thực thi nhanh hơn 3.8× so với XlsxWriter của Python. Để biết chi tiết đầy đủ, xem kho lưu trữ rust_xlsxwriter trên GitHub.
Bắt đầu với rust_xlsxwriter
rust_xlsxwriter có sẵn trên crates.io và có thể được cài đặt bằng `cargo add rust_xlsxwriter`. Để tăng cường chức năng, hãy bật các tính năng tùy chọn như `constant_memory`, `chrono`, `serde`, hoặc `polars`. Thư viện yêu cầu Rust 1.56+ và biên dịch thành các binary gốc mà không có phụ thuộc thời gian chạy bên ngoài ngoài crate `zip` (mặc định). Nó được tài liệu đầy đủ với hướng dẫn người dùng, tutorial và cookbook. Để xem các ví dụ chi tiết và mã nguồn, hãy truy cập kho lưu trữ rust_xlsxwriter trên GitHub.
Cài đặt rust_xlsxwriter qua Cargo
cargo add rust_xlsxwriterGhi các ô đã định dạng với Văn bản, Số và Ngày
rust_xlsxwriter cung cấp một API đơn giản và trực quan để ghi nội dung định dạng vào các ô Excel. Các nhà phát triển có thể áp dụng các định dạng tùy chỉnh cho số, ngày, phông chữ, viền, căn chỉnh và màu sắc bằng cấu trúc `Format`. Thư viện hỗ trợ ghi văn bản thuần, giá trị số, ngày, công thức và URL với định dạng tùy chọn. Nó cũng hỗ trợ các chuỗi đa định dạng phong phú cho việc định dạng hỗn hợp trong một ô duy nhất. Điều này làm cho nó trở nên lý tưởng cho việc tạo báo cáo, bảng điều khiển và xuất dữ liệu nơi mà độ rõ ràng và cấu trúc hình ảnh là cần thiết. API đảm bảo độ trung thực cao với engine định dạng gốc của Excel.
Cách ghi Văn bản, Số và Ngày đã định dạng bằng 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")?;Tạo biểu đồ, sparklines và hình ảnh
rust_xlsxwriter hỗ trợ tạo các biểu đồ chuyên nghiệp, sparklines và chèn hình ảnh trực tiếp vào tệp Excel. Các nhà phát triển có thể tạo biểu đồ cột, đường, tròn, phân tán và khu vực với các trục, chú giải và chuỗi dữ liệu có thể tùy chỉnh. Sparklines cung cấp hình ảnh xu hướng gọn gàng trong các ô. Hình ảnh (PNG, JPEG, GIF, BMP) có thể được chèn và định vị với các tùy chọn thu phóng và neo. Những yếu tố hình ảnh này nâng cao khả năng kể chuyện dữ liệu và báo cáo. Thư viện đảm bảo tương thích với Excel 2007+ và giữ nguyên độ chính xác khi hiển thị trên các nền tảng.
Cách Thêm Biểu Đồ & Hình Ảnh vào Excel bằng 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")?;Định dạng nâng cao: Gộp ô, Bảng và Định dạng có điều kiện
rust_xlsxwriter cho phép sử dụng các tính năng định dạng Excel nâng cao như vùng hợp nhất, bảng có cấu trúc, bộ lọc tự động và quy tắc định dạng có điều kiện. Các nhà phát triển có thể hợp nhất các ô cho tiêu đề hoặc nhãn, áp dụng kiểu bảng với các hàng/cột xen kẽ, và định nghĩa bộ lọc để tăng tính tương tác cho người dùng. Định dạng có điều kiện hỗ trợ thang màu, thanh dữ liệu, bộ biểu tượng và công thức tùy chỉnh để làm nổi bật xu hướng hoặc bất thường. Những tính năng này cải thiện khả năng đọc dữ liệu và tính tương tác trong các workbook được tạo ra. API trừu tượng hoá cấu trúc XML phức tạp thành các phương thức Rust trực quan, đảm bảo khả năng bảo trì và an toàn kiểu dữ liệu.
Cách Gộp Ô & Thêm Bảng với Định Dạng Có Điều Kiện?
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")?;Tối ưu hoá hiệu năng & Hỗ trợ tệp lớn
rust_xlsxwriter được tối ưu hóa cho tốc độ và hiệu quả bộ nhớ, đặc biệt đối với các bộ dữ liệu lớn. Nó hỗ trợ chế độ bộ nhớ cố định (`constant_memory` feature), ghi dữ liệu từng phần vào đĩa, giảm thiểu việc sử dụng heap. Chế độ này lý tưởng để tạo các tệp Excel đa megabyte mà không gặp lỗi OOM. Các phép đo cho thấy nó chạy nhanh khoảng ~3.8× so với XlsxWriter của Python và chỉ chậm khoảng ~14% so với thư viện C gốc. Các tính năng tùy chọn như `zmij` và `zlib` còn tăng tốc việc ghi số và nén. Những khả năng này làm cho nó phù hợp cho báo cáo hàng loạt, các pipeline ETL và việc tạo Excel phía máy chủ.
Cách Kích Hoạt Chế Độ Bộ Nhớ Cố Định cho Các Tập Tin Lớn?
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")?;