Text.js
错误代码/@textjs/core

TX001

Yoga 尚未初始化

控制台

Text.js error TX001: Yoga is not initialized. Call `await initYoga()` (or `await createConsoleRoot()`) before rendering.

发生原因

布局运行在 Yoga 上，Yoga 以 WebAssembly 形式提供，必须在第一帧之前实例化。在 initYoga() 完成之前，有代码同步创建了场景节点或根节点。

修复方法

使用异步根节点辅助函数，它们会为你初始化 Yoga：

import { createConsoleRoot } from "@textjs/react";const root = await createConsoleRoot();root.render(<App />);

如果需要使用 createConsoleRootSync() 或直接操作核心场景图，在启动时等待一次 initYoga() 完成：

import { initYoga } from "@textjs/core";await initYoga();

通过 text dev 启动的应用不会出现此错误。