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 啟動的應用程式不會遇到此錯誤。