
xlsxwriter-rs
Thư viện Rust cho việc Tạo Excel XLSX
Tạo các tệp Excel XLSX hoàn toàn tương thích với Định dạng, Hợp nhất ô, Bộ lọc tự động & Hình ảnh thông qua API Rust.
xlsxwriter-rs là gì?
xlsxwriter-rs là một binding Rust hiệu năng cao cho thư viện C libxlsxwriter được sử dụng rộng rãi, cho phép các nhà phát triển tạo ra các tệp Excel XLSX hoàn toàn tương thích trực tiếp từ các ứng dụng Rust. Nó hỗ trợ định dạng Excel toàn diện, bao gồm phông chữ, màu sắc, căn chỉnh, viền và định dạng số, cũng như các tính năng nâng cao như hợp nhất ô, bộ lọc tự động, xác thực dữ liệu và nhúng hình ảnh PNG/JPEG. Được thiết kế để đáng tin cậy và nhanh chóng, xlsxwriter-rs là lựa chọn lý tưởng cho việc tạo báo cáo phía máy chủ, các pipeline xuất dữ liệu, và bất kỳ kịch bản nào yêu cầu tạo tệp Excel một cách lập trình trong Rust.
Thư viện tận dụng tính an toàn bộ nhớ và các trừu tượng không tốn chi phí của Rust để cung cấp một API an toàn và hiệu quả cho việc tạo Excel mà không cần Microsoft Excel hoặc các phụ thuộc bên ngoài như COM. Nó tích hợp liền mạch với Cargo và hỗ trợ các cờ tính năng tùy chọn để tùy chỉnh hành vi, chẳng hạn như vô hiệu hoá checksum MD5 hoặc sử dụng zlib hệ thống. Với giao diện Rust sạch sẽ, mang tính idiomatic và tài liệu toàn diện, xlsxwriter-rs cho phép các nhà phát triển xây dựng công cụ tạo Excel mạnh mẽ, đa nền tảng đồng thời duy trì kiểm soát đầy đủ đối với cấu trúc và nội dung tệp.
Bắt đầu với xlsxwriter-rs
Để bắt đầu sử dụng xlsxwriter-rs, thêm nó vào Cargo.toml của bạn qua cargo add xlsxwriter hoặc tự động bao gồm [dependencies] với xlsxwriter = "0.1". Thư viện yêu cầu LLVM và Clang để biên dịch bindgen. Đối với Windows, cài đặt Visual Studio và LLVM, sau đó đặt LIBCLANG_PATH tới thư mục bin của LLVM. Sau khi thiết lập, sao chép kho lưu trữ, chạy git submodule update --init --recursive để tải thư viện C, và xây dựng các ví dụ với cargo run --example hello_spreadsheet. Tài liệu đầy đủ và các ví dụ có sẵn trên GitHub xlsxwriter-rs.
Cài đặt xlsxwriter-rs qua Cargo
cargo add xlsxwriterHỗ trợ đầy đủ định dạng Excel
xlsxwriter-rs cung cấp khả năng định dạng toàn diện, cho phép các nhà phát triển tùy chỉnh phông chữ, màu sắc, viền, căn chỉnh và định dạng số cho từng ô hoặc phạm vi. Bạn có thể áp dụng in đậm, in nghiêng, gạch chân, kích thước phông chữ và màu tùy chỉnh cho văn bản, đặt màu nền, định nghĩa viền ô với các kiểu khác nhau (mỏng, trung bình, dày), và kiểm soát căn chỉnh ngang/dọc. Mức độ kiểm soát này đảm bảo các tệp Excel được tạo ra đáp ứng tiêu chuẩn báo cáo chuyên nghiệp. Định dạng được áp dụng bằng cấu trúc Format, hỗ trợ chuỗi phương thức để cấu hình trực quan. Tính năng này rất cần thiết cho việc tạo các báo cáo, bảng điều khiển và xuất dữ liệu có hình ảnh rõ ràng, cải thiện khả năng đọc và trải nghiệm người dùng.
Áp dụng màu phông chữ và căn chỉnh cho các ô
let mut sheet1 = workbook.add_worksheet(None)?;
sheet1.write_string(
0, 0,
"Red text",
Some(&Format::new().set_font_color(FormatColor::Red))
)?;
sheet1.write_string(
2, 0,
"Centered green text",
Some(&Format::new()
.set_font_color(FormatColor::Green)
.set_align(FormatAlignment::CenterAcross)
.set_vertical_align(FormatVerticalAlignment::VerticalCenter)
)
)?;Các ô và phạm vi được hợp nhất
Thư viện hỗ trợ việc hợp nhất các phạm vi ô hình chữ nhật, điều này rất quan trọng cho việc tạo tiêu đề, tiêu đề phụ và các phần dữ liệu được nhóm trong báo cáo Excel. Sử dụng phương thức merge_range, bạn có thể mở rộng qua nhiều hàng và cột đồng thời áp dụng định dạng cho toàn bộ khối đã hợp nhất. Điều này đảm bảo kiểu dáng và bố cục nhất quán trên các bảng tính phức tạp. Các ô đã hợp nhất hoàn toàn tương thích với công cụ hiển thị của Excel và giữ nguyên định dạng như căn chỉnh văn bản, viền và màu nền. Tính năng này đặc biệt hữu ích cho báo cáo tài chính, bảng điều khiển và các mẫu biểu mẫu nơi việc nhóm trực quan nâng cao khả năng hiểu dữ liệu và chất lượng trình bày.
Hợp nhất một phạm vi với định dạng tùy chỉnh
sheet1.merge_range(
2, 0,
3, 2,
"Hello, world",
Some(&Format::new()
.set_font_color(FormatColor::Green)
.set_align(FormatAlignment::CenterAcross)
.set_vertical_align(FormatVerticalAlignment::VerticalCenter)
)
)?;Bộ lọc tự động và xác thực dữ liệu
xlsxwriter-rs cho phép tạo tự động các autofilter và quy tắc xác thực dữ liệu một cách lập trình, cho phép người dùng sắp xếp, lọc và xác thực dữ liệu trực tiếp trong Excel. Bạn có thể áp dụng autofilter cho một phạm vi ô bằng cách sử dụng set_autofilter, và định nghĩa danh sách thả xuống cho người dùng nhập liệu thông qua xác thực dữ liệu. Điều này hỗ trợ xác thực dựa trên danh sách, phạm vi số, ngày tháng và công thức tùy chỉnh. Các tính năng này tăng cường tính tương tác và tính toàn vẹn dữ liệu trong bảng tính, làm cho chúng phù hợp cho biểu mẫu, mẫu và nhập liệu hợp tác. Các tệp XLSX được tạo ra giữ nguyên đầy đủ chức năng khi mở trong Excel, LibreOffice hoặc Google Sheets, đảm bảo khả năng tương thích rộng rãi.
Áp dụng bộ lọc tự động và xác thực dữ liệu
// Apply autofilter to A1:C10
sheet1.set_autofilter("A1:C10")?;
// Add data validation (drop-down list) in B2
sheet1.data_validation(
"B2",
DataValidation::new_list(&["Option1", "Option2", "Option3"])
)?;Nhúng hình ảnh và siêu liên kết
Bạn có thể nhúng hình ảnh PNG và JPEG trực tiếp vào các bảng tính Excel bằng xlsxwriter-rs, hỗ trợ việc định vị, thay đổi kích thước và thu phóng. Điều này lý tưởng cho việc thêm logo, biểu đồ hoặc các chỉ báo trực quan vào báo cáo. Ngoài ra, thư viện còn hỗ trợ siêu liên kết và URL với định dạng tùy chỉnh (ví dụ: văn bản màu xanh và gạch chân), cho phép tạo liên kết có thể nhấp vào các trang web, tài liệu hoặc các sheet khác. Những khả năng này khiến xlsxwriter-rs phù hợp để tạo các báo cáo và bảng điều khiển phong phú, tương tác, kết hợp dữ liệu, hình ảnh và điều hướng. Tất cả nội dung được nhúng hoàn toàn tương thích với engine render của Excel và giữ nguyên tính toàn vẹn bố cục trên các nền tảng.
Ghi URL và nhúng hình ảnh
// Write a clickable URL
sheet1.write_url(
1, 1,
"https://github.com/informationsea/xlsxwriter-rs",
Some(&Format::new()
.set_font_color(FormatColor::Blue)
.set_underline(FormatUnderline::Single)
)
)?;
// Embed an image (requires image path)
// sheet1.insert_image(5, 0, "logo.png")?;