没有 JSX,也能在 Go 里写 React 风格 GUI:Tenon 的架构与性能实践

0 阅读4分钟

Go 写 GUI,能不能也像写 React 一样?

我们希望可以用函数组件组织界面,用 Hooks 管理状态,用 Flexbox 完成布局,同时保留 Go 的类型系统、工具链和部署体验。Tenon 就是在做这件事。

Tenon 是一个用 Go 编写的声明式 GUI 框架:函数组件 + Hooks,Yoga 负责 Flexbox 布局,Gio 负责渲染。

项目地址:github.com/sjm13276059…

Tenon Accordion 示例

先看一下代码

下面是一个计数器:

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 的核心模型分为三层:

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。

仓库:github.com/sjm13276059…