Brief

选题

中文/日文 Text 一更新,终端被 ICU4X data error: No segmentation model for language: ja 刷屏。根因不是“翻译系统坏了”,而是 Bevy 文本栈迁到 Parley 后,布局依赖 ICU4X 分词,默认没带 CJK 词典数据

目标读者

  • 用 Bevy 0.19+ 做中文 UI / LLM 流式字幕的开发者
  • 想理解 bevy_text → Parley → ICU4X 依赖链的人

正文落点

Vault My Blog/中文一改就刷屏.mdshare: false 起草)

核心论点(必须有源)

  1. 报错来自 ICU4X icu_segmenter complex 路径,不是 Bevy 自己 println — issue 评论定位源码
  2. 调用链:Text layout → Parley → ICU4X segmentation
  3. 历史:#22879 Parley 迁移引入;#23841 IME 已观察到同样刷屏
  4. ja ≠ 你的 locale 被设成日语:ChineseOrJapanese 共用 bucket,display context 为 ja
  5. 正道修复:#24683 暴露 complex_script_segmentationparley/complex-scripts(截至 2026-07-26 仍 open
  6. 0.19.0 = parley 0.9.0,无该 feature;main 已 parley 0.11 但仍缺 Bevy 侧透传(PR 未合)
  7. 临时:降日志 / 合并更新频率;合入后开 feature(二进制变大)

非论点(避免写错)

  • 不要写成 Bevy 官方 i18n/Fluent 方案
  • 不要声称中文无法显示(多数报告是能显示、日志炸)
  • 不要写 #24683 已合并(调研日仍 open)

结构建议

  1. 现象(流式中文 / 按钮 append)
  2. 读懂那一行报错
  3. 考古:Cosmic → Parley → ICU4X
  4. 为啥是 ja
  5. 社区修法与 workaround
  6. 中文项目今天怎么配

标题候选(≤12 字)

  • 中文一改就刷屏(采用)
  • CJK 断词告警
  • Parley 的 CJK 税

审核关注

  • PR/版本状态日期钉死 2026-07-26
  • 代码示例仅作示意,标注 feature 名以合入后为准
  • 封面:技术图(依赖链 / 终端日志意象),少堆 tag

相关

  • bevy-blog
  • raw: raw/articles/bevy-issue-24094-icu4x-segmentation-2026-07-26.md