第一章 认识 egui¶
1.1 egui 是什么¶
egui是一个用纯 Rust 写的 GUI 库。它有三个特点:
- 简单:写法直白,没有回调、没有信号槽。
- 快:debug 构建下也能跑到 60 FPS。
- 可移植:同一份代码能编译成桌面程序,也能编译成网页(WebAssembly)。
它不依赖任何操作系统提供的控件,所有按钮、文字、窗口都是 egui 自己画出来的。所以它长得不像 Windows 或 macOS 的原生界面,但好处是到哪里都长一个样。
egui 自己只是个“画界面”的库,它不知道自己在什么系统上跑、不知道怎么读鼠标键盘、不知道怎么把像素画到屏幕上。这些事交给“集成(integration)”来做。官方提供的集成叫 eframe,它把 egui 包装成一个可以直接跑的程序框架。
1.2 egui 能做什么¶
按官方 README 列举的功能:
- 控件:标签(label)、按钮、超链接、复选框、单选按钮、滑块、可拖动的数值、文本编辑、颜色选择器、加载动画(spinner)。
- 图片:支持加载并显示。
- 布局:水平、垂直、分列、自动换行。
- 文本编辑:多行、复制粘贴、撤销、支持 emoji。
- 窗口:可拖动、可缩放、可命名、可最小化、可关闭,自动定位与大小。
- 区域:可缩放、垂直滚动、折叠标题、面板。
- 渲染:线、圆、文字、凸多边形的抗锯齿渲染。
- 悬浮提示(tooltip):鼠标悬停时显示。
- 可访问性:通过 AccessKit 支持屏幕阅读器。
- 可选文本:标签里的文字可以被选中。
1.3 egui 适合谁用¶
- 你在用 Rust 写一个交互式程序,想加个简单界面。
- 你在写游戏,想在游戏里加个调试面板或设置界面。
- 你想写一个网页小程序,又不想学前端那一套。
egui 不适合:
- 不用 Rust 的人。
- 想要原生外观的人。
- 想要一次写好、以后升级不坏的人(egui 还在快速迭代,新版本经常有破坏性改动)。
1.4 仓库结构¶
egui 是一个 monorepo,由多个 crate 组成。理解这些 crate 的分工很重要:
| crate | 作用 |
|---|---|
emath |
最基础的 2D 数学:Vec2、Pos2、Rect、lerp、remap。 |
ecolor |
颜色类型。 |
epaint |
能变成带纹理三角形的 2D 形状和文字。 |
epaint_default_fonts |
内嵌的默认字体。 |
egui |
主库。所有控件、布局、Context、Ui、Response 都在这里。只依赖 emath 和 epaint。 |
egui_extras |
在 egui 之上的附加功能,比如图片加载器。 |
egui-winit |
把 winit 的事件翻译给 egui。 |
egui_glow |
用 glow(OpenGL)把 egui 画出来。 |
egui-wgpu |
用 wgpu(WebGPU)画。 |
eframe |
官方框架,把上面这些组装起来,让你写一份代码同时跑在桌面和网页。 |
egui_demo_lib |
演示代码,可以当参考。 |
egui_demo_app |
把 egui_demo_lib 打包成可执行程序或网页。 |
egui_kittest |
基于 kittest 和 AccessKit 的测试框架。 |
egui_plot |
折线图等绘图。 |
简单说:
emath/epaint是底层;egui是核心;eframe是让你能跑起来的框架。
1.5 一段最小示例¶
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}"));
这段代码做的事:放一个标题,放一行(标签 + 文本框),放一个滑块,放一个按钮,按钮被点就 age += 1,最后显示问候语。
读这段代码你就明白 egui 的风格了:你写 UI 的过程,就是 UI 真正在显示的过程。没有“先创建按钮、再注册回调”这一套。下一章我们会从零跑起来。