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/中文一改就刷屏.md(share: false 起草)
核心论点(必须有源)
- 报错来自 ICU4X
icu_segmentercomplex 路径,不是 Bevy 自己 println — issue 评论定位源码 - 调用链:Text layout → Parley → ICU4X segmentation
- 历史:#22879 Parley 迁移引入;#23841 IME 已观察到同样刷屏
ja≠ 你的 locale 被设成日语:ChineseOrJapanese 共用 bucket,display context 为ja- 正道修复:#24683 暴露
complex_script_segmentation→parley/complex-scripts(截至 2026-07-26 仍 open) - 0.19.0 = parley 0.9.0,无该 feature;main 已 parley 0.11 但仍缺 Bevy 侧透传(PR 未合)
- 临时:降日志 / 合并更新频率;合入后开 feature(二进制变大)
非论点(避免写错)
- 不要写成 Bevy 官方 i18n/Fluent 方案
- 不要声称中文无法显示(多数报告是能显示、日志炸)
- 不要写 #24683 已合并(调研日仍 open)
结构建议
- 现象(流式中文 / 按钮 append)
- 读懂那一行报错
- 考古:Cosmic → Parley → ICU4X
- 为啥是 ja
- 社区修法与 workaround
- 中文项目今天怎么配
标题候选(≤12 字)
- 中文一改就刷屏(采用)
- CJK 断词告警
- Parley 的 CJK 税
审核关注
- PR/版本状态日期钉死 2026-07-26
- 代码示例仅作示意,标注 feature 名以合入后为准
- 封面:技术图(依赖链 / 终端日志意象),少堆 tag
相关
- bevy-blog
- raw:
raw/articles/bevy-issue-24094-icu4x-segmentation-2026-07-26.md