egui: thư viện GUI immediate mode cho Rust

egui là gì?

egui là một thư viện Rust để dựng giao diện đồ họa tương tác kiểu immediate mode: mỗi widget được vẽ lại và kiểm tra từ đầu ở mỗi frame, thay vì sống trong một cây widget tồn tại lâu dài kèm handler gắn sẵn. egui chạy trên web qua WebAssembly, chạy native trên desktop qua eframe, và nhúng được vào bất kỳ renderer nào vẽ được tam giác có texture. Bạn gọi egui vào từ chính render loop của mình, không phải ngược lại.

egui cung cấp những gì

• ✓Bộ widget khá đủ: label, button, checkbox, radio button, slider, giá trị kéo-thả (draggable value), color picker, spinner, cùng trình soạn thảo text hỗ trợ copy/paste, undo và emoji.
• ✓Các helper layout cho bố cục ngang, dọc, chia cột, tự động xuống dòng, cộng thêm panel, collapsing header và vùng scroll.
• ✓Window di chuyển, resize được, tự tính kích thước và tự định vị.
• ✓Render anti-aliased cho line, circle, text và convex polygon qua lớp đồ họa 2D riêng có tên epaint.
• ✓Hỗ trợ accessibility tuỳ chọn qua AccessKit, có screen reader native trên Windows và macOS.
• ✓Hiển thị ảnh có sẵn, việc load ảnh được đẩy sang crate egui_extras để core egui giữ được ít phụ thuộc.
• ✓Cùng một đoạn code UI chạy được cả trên bản native lẫn trên web qua WebAssembly, không cần viết lại.

Thêm egui vào dự án Rust

README không đưa ra một dòng lệnh cargo add egui duy nhất; thay vào đó chỉ ra hai hướng bắt đầu. Nếu làm app desktop hoặc web, clone github.com/emilk/eframe_template rồi làm theo hướng dẫn trong đó, nó đã cấu hình sẵn eframe, framework chính thức, cho bạn. Nếu muốn dùng egui trần, nhúng vào engine hoặc renderer riêng, docs chính thức tại docs.rs/egui hướng dẫn cách tích hợp trực tiếp. Repo cũng có ví dụ mẫu trong thư mục examples/. Chạy demo app trên Linux cần cài thêm gói hệ thống trước, libclang-dev, libgtk-3-dev và một loạt gói dev libxcb/libxkbcommon/openssl, nhưng đây là yêu cầu riêng của demo app, không phải của egui; README nói rõ bản thân egui không phụ thuộc platform.

Viết UI egui đầu tiên

Một UI egui tối thiểu đọc như code Rust bình thường: không markup riêng, không XML, không phải tạo sẵn object builder rồi nối vào callback: ```rust ui.heading("My egui Application"); ui.horizontal(|ui| { ui.label("Your name: "); ui.text_edit_singleline(&mut name); }); ui.add(egui::Slider::new(&mut age, 0..=120).text("age")); if ui.button("Increment").clicked() { age += 1; } ui.label(format!("Hello '{name}', age {age}")); ui.image(egui::include_image!("ferris.png")); ``` Mỗi dòng ở trên chạy lại ở frame tiếp theo; đó chính là ý nghĩa của "immediate mode". Không gì tồn tại giữa các frame. Pattern `if ui.button(...).clicked()` thay thế cho một handler on-click: bạn kiểm tra giá trị trả về ngay tại chỗ button được vẽ, nên state của app (`name`, `age`) và state của UI không bao giờ lệch nhau.

Các thư viện GUI Rust khác đáng cân nhắc

Câu hỏi thường gặp

Vấn đề mà egui giải quyết

Phần lớn crate GUI của Rust bắt bạn chọn phe từ sớm: bind vào một toolkit native nặng và tự lo mấy vấn đề đóng gói riêng theo từng platform, hoặc dùng một framework đầy đủ với vòng đời app riêng, ép code phải tổ chức theo cách của nó. Không cách nào trong hai cách đó cho bạn vẽ UI ngay bên trong một render loop có sẵn, ví dụ như hàm update mỗi frame của một game engine, mà không cần thêm lớp glue. egui lấp đúng khoảng trống hẹp đó: một thư viện widget bạn gọi trực tiếp từ bất kỳ chỗ nào bạn đang vẽ, dù đó là một renderer wgpu trần hay một hook mỗi frame của game engine.

Trường hợp sử dụng tốt nhất

• •Overlay debug/inspector cho game hoặc simulation, vẽ trực tiếp từ code Rust ở mỗi frame.
• •Công cụ desktop nhỏ, dùng nội bộ hoặc cá nhân, nơi ra sản phẩm nhanh quan trọng hơn giao diện giống native.
• •Tooling trong game engine, level editor, panel chỉnh tham số, debug HUD, gắn qua bevy_egui hoặc một tích hợp tự viết.
• •Web app thuần Rust biên dịch sang WASM, cần control tương tác mà không đụng tới JavaScript.

Ai nên dùng — và ai nên bỏ qua

Nên thử egui nếu bạn là dev Rust cần một debug panel, màn hình config, hay UI công cụ nhẹ phải ra được trong tuần này thay vì phải khớp style OS. Nó hợp với dự án solo hay team nhỏ, dev game gắn tooling ngay trong engine, và bất kỳ ai thích viết `if ui.button(...).clicked()` hơn là quản lý object handler. Bỏ qua nếu bạn không viết Rust, cần UI không thể phân biệt với giao diện native của OS, hoặc không chịu được breaking change giữa các bản release; README nói rõ interface vẫn đang thay đổi.

Repo liên quan