Go 写 GUI,能不能也像写 React 一样?
我们希望可以用函数组件组织界面,用 Hooks 管理状态,用 Flexbox 完成布局,同时保留 Go 的类型系统、工具链和部署体验。Tenon 就是在做这件事。
Tenon 是一个用 Go 编写的声明式 GUI 框架:函数组件 + Hooks,Yoga 负责 Flexbox 布局,Gio 负责渲染。
项目地址:github.com/sjm13276059...

先看一下代码
下面是一个计数器:
go
package main
import (
"fmt"
ui "github.com/sjm1327605995/tenon/pkg/ui"
)
func Counter() *ui.Node {
count, setCount := ui.UseState(0)
return ui.HStack(16,
ui.Button(ui.Text("-")).OnClick(func() {
setCount(count - 1)
}),
ui.Text(fmt.Sprintf("%d", count)).FontSize(32),
ui.Button(ui.Text("+")).OnClick(func() {
setCount(count + 1)
}),
).Padding(24)
}
func main() {
ui.Run(ui.View(Counter))
}
没有 JSX,也不需要 XML 或模板语言。组件就是普通 Go 函数,状态更新只重渲染当前组件。
三棵树,而不是一棵"全能树"
Tenon 的核心模型分为三层:
text
Node 不可变的 UI 描述
↓ reconcile
Fiber 保存组件身份、Hooks 和子树
↓
renderNode 保存 Yoga 节点、布局结果和绘制状态
Node 描述"界面应该是什么",Fiber 决定"组件还是不是原来的组件",renderNode 负责"最终怎么布局和绘制"。
这种拆分带来几个直接收益:
- 状态更新只重渲染对应 Fiber,不必重建整个应用。
- 样式、文本和结构变化可以走不同的更新路径。
- 测试可以不打开窗口,直接驱动真实的协调、布局和命中过程。
- Yoga 与 Gio 不需要理解 React 式组件和 Hooks。
目前能做什么
目前 Tenon 已包含:
UseState、UseEffect、UseReducer、UseMemo、UseCallback、UseRef、UseContext- Fragment、Portal、ErrorBoundary、keyed reconciliation
- 文本折行、富文本、IME、选区、剪贴板
- 键盘焦点、焦点陷阱、方向键导航
- 动画、变换、伪 3D 场景
- SVG 图标、图片、渐变、圆角和阴影
- 约 42 个 shadcn 风格组件
- 声明式 API、路由、数据绑定和热重载
- 无头测试 Harness 与 Gio 像素测试
Yoga 也已补齐到 3.2.1 功能基线 ,支持 display: contents、BoxSizing、配置缓存版本,以及类型化的布局和生命周期事件。
从 14.6ms 到约 4ms:优化主要做了什么
下面是一组 Windows 开发机上的 Gio headless 基准。它用于比较同一环境下的优化前后结果,不代表所有设备的实际帧率。
| 场景 | 优化前 | 优化后 |
|---|---|---|
| 文本 + 图标 + 阴影 | 14.59ms/帧 | 约 4.07ms/帧 |
| 阴影场景 | 11.27ms/帧 | 约 2.03ms/帧 |
| 图标场景 | 2.87ms/帧 | 约 0.95ms/帧 |
| 无 key 子节点协调 | 87.4µs、407 次分配 | 约 17.5µs、0 分配 |
| 悬停处理 | 274.5ns、2 次分配 | 约 2.1ns、0 分配 |
提升主要来自四类改动。
第一,减少重复绘制。
模糊阴影不再每帧生成多组圆角路径,而是首次通过 CPU 生成位图,后续直接贴图。普通图片也复用 ImageOp,避免重复复制和上传。
第二,复用不可变结果。
SVG 路径按本地坐标只解析一次,绘制时通过仿射平移。文本测量、折行和 Gio 字形也各自利用缓存。
第三,减少树操作中的临时对象。
无 key 子节点直接在原 Fiber 切片上协调;props 使用小型对象池;稳定树的 relink 不再为每个容器创建临时切片。
第四,避免无意义的查找。
悬停状态不再为每帧创建 map,而是使用父节点上的子索引位图。命中测试则根据光标位置和布局版本缓存,只有真正发生变化时才重新遍历。
静态帧还可以直接回放之前记录的 Gio 宏,不必重新生成整棵绘制树。
优化中学到的几件事
先测量,再优化。 阴影和 SVG 的收益远大于单纯调整几个小函数。文本整形 Gio 已经有缓存,就没有必要再重复造一套。
缓存必须同时设计失效规则。 布局、动画、焦点、选区、Portal、光标闪烁都可能让缓存过期。只写"提高命中率"很容易,难的是保证不会显示旧内容。
不是所有 map 都该换成 bitmap。 字符串 key 和稀疏指针集合仍然适合哈希表。只有层级和子索引明确的树状态,位图才真正有优势。
热身后的性能不等于完整性能。 首帧、冷缓存、内存峰值和长时间运行同样重要,也是后续继续验证的方向。
目前适不适合生产使用?
Tenon 目前更适合原型、内部工具、桌面应用试验,以及对 Go GUI 感兴趣的开发者。
它仍然处于 active-alpha 阶段:
- API 可能继续调整。
- 多窗口、无障碍树和 BiDi 文本仍未完成。
- 跨平台和真实窗口验证还需要继续加强。
- 冷启动和大数据量下的内存表现还需要更多测试。
这些限制都会在 Roadmap 中公开,而不是把"能运行"包装成"已经成熟"。
接下来
接下来的重点不是无限增加功能,而是:
- 统一缓存失效管理;
- 压缩 Yoga 节点内存;
- 加强真实窗口和跨平台测试;
- 完善性能回归基准;
- 整理可审查、可回滚的版本与迁移文档。
如果你对 Go GUI、声明式 UI、Flexbox、Gio 或渲染性能感兴趣,欢迎试用、反馈或提交 PR。