# paint thread > CrossFly 的线程模型 —— 在 paint thread 上单线程、onUI 以及按需渲染。 Source: https://crossfly.dev/zh/docs/concepts/the-paint-thread — CrossFly documentation. Full docs as one file: https://crossfly.dev/llms-full.txt # paint thread 这大概是框架中最重要的一条规则，用来避免你的应用出错。 ## CrossFly 在 paint thread 上是单线程的 **所有** UI 与渲染操作都发生在**单一一条线程**上 —— 即 *paint thread*。`Main` 始终在其上调用 `create()`、`render()` 和 `resize()`；每一个 `onShow`、`onPaint`、`onLayout`、触摸回调以及组件变更都在其中运行。 **为什么做这个决定？** 简单与正确。只有一条执行线操作 UI，绘制路径上就**没有锁，也没有被争用的共享状态**。代价是你必须遵守的一条规则：**绝不要从其他线程碰 UI**。 ## 标准范式：重活在外，UI 用 `onUI` 回来网络、数据库、文件、长时间计算 → **后台线程**。要用结果去**碰 UI**，就用 `Component.onUI(...)` 回到 paint thread： ```java new Thread(() -> { List dados = repositorio.buscarTudo(); // 繁重工作，后台 thread Component.onUI(() -> { // 回到 paint thread lista.setItems(dados); // 现在可以安全操作 UI Component.repaint(); // 请求新的一帧 }); }).start(); ``` 此外还有 `Main.runOnPaintThread(Runnable)`（以及变体 `runOnPaintThreadAndWait(...)`）用于在 `Component` 上下文之外达到同样目的。 > 违反该规则的典型症状：当你从网络/定时器回调内部"刷新屏幕"时，应用崩溃或 > 表现异常。修正办法始终是**用 `onUI(...)` 包裹对 UI 的操作**。 ## 按需渲染 paint thread **不会持续重绘**。只有当有人调用 **`repaint()`**（内部为 `Gdx.graphics.requestRendering()`）时才会生成新帧。这能省电 —— 静止的屏幕不消耗 GPU。大多数组件的 setter 已经替你调用了 `repaint()`。需要记住的后果： - **改了框架不知道的东西？** 你自己调用 `repaint()`。 - **动画？** 它需要在每一帧**保持渲染请求存活**（这正是动画器在 `onUpdate` 中所做的；参见 [值动画](/docs/ui/animations/value-animations)）。

## 参见 - 相关：[渲染管线](/docs/concepts/rendering-pipeline) · [状态与数据流](/docs/concepts/state-and-data-flow) - 下一篇：[Layout 与 Relative 模型](/docs/concepts/the-layout-and-relative-model)