VisualHMI 多言語与字库：30 种语言切换、字库裁剪、ストリング·ストリング ID 维护铁律

VisualHMI 的多言語方案很省事：一套 UI，多言語词条，一1つのレジスタ切换。不用给每种语言做一套画面。这篇把字库、文字タグ、ストリング·ストリング ID 维护讲透——最后那节"ストリング·ストリング ID 维护"是デバイス出货后最容易踩的坑，务必看完。

1. 多言語怎么工作

核心思路：UI 上的文字不放死，用控件引用语言词条；工程属性里の設定语言数（最大 30 种）；运行时設定多言語システム·レジスタ，一键切换すべての词条。

2. 字库管理

2.1 系统自带字库

软件自带 5 个字库：

2.2 追加字库

字库設定里点【追加】→ 选 ttf 文件。新字库会在工程目录下新建 font 文件夹并放入该文件。

2.3 替换字库

控件表示的字库和索引关联。把 Arabic.ttf 替换成 wqyMicroHeiMono：把 Arabic 索引改为 0，キャンセル勾选 wqy 即可。

2.4 削除字库

系统自带字库サポートなし。削除；用户追加的字库可以删。

2.5 裁剪字库（省 Flash 空间）

VisualHMI 集成字库裁剪工具：【工程】→【字库裁剪】。選択要裁剪的字库 → 加载需要保留的文字集合（txt 必须 UTF-8 Coding）→ 开始裁剪，生成 xxx_cut.ttf。

新版还サポート工程文字裁剪：编译生成下载文件时自动裁剪，有四种モード：

3. 文字タグ（多言語的正确打开方式）

文字タグ = 一个词条容器，含すべての语言的译文。控件引用同一个文字タグ，改一处、全语言生效，不用重复写文字。

菜单栏【文字タグ】打开管理窗口，サポート新增、修改、Delete、export、Import。

3.1 增加文字タグ

点【新增】，デフォルト名 text1，可改成有含义的名字（如"温度の設定"），把各语言译文填到对应语言列。

3.2 EXCEL Edit

点【EXCEL Edit】，タグ以表格形式打开，直接編集，保存关闭后回到文字タグ窗口確認即可。

3.3 export / Import

サポート导出 xml、csv、xlsx 修改，再导入。适合批量翻译和多人协作。

4. ストリング·ストリング ID 维护（出货后最重要，必看）

编译时生成一张最终ストリング·ストリング表。ストリング·ストリングSource:

• 文字タグ表里的文字：用户主动维护，每条有固定 ID，用 $ 引用（如 $温度の設定）
• 直接填写的文字：控件里直接写的文字，编译时自动加入ストリング·ストリング表末尾（无固定 ID）
• 告警設定的ストリング·ストリング：告警内容，用 $ 引用则用固定 ID，直接填写则自动追加

关键：履歴不保存文字，只保存ストリング·ストリング ID：

履歴 = time + ストリング·ストリングID
操作记录 = time + 操作ストリング·ストリングID + 值变化
告警记录 = 告警时间 + 告警ストリング·ストリングID

表示历史时，デバイス用保存的 ID to当前版本的ストリング·ストリング表里查文字。所以ストリング·ストリング表是历史データ的解释字典——一旦发布，ID 的含义不能变。

5. ストリング·ストリング ID 维护ルール（照做不翻车）

1. 会被デバイス保存的文字必须用固定文字タグ ID：操作记录内容、参数説明、履歴引用的文字、告警内容
2. 已发布使用过的 ID 不能削除：即使这条以后不用了，也要保留原 ID
3. 已发布的 ID 不能复用：旧 ID 不能分配给新的内容
4. 已发布的 ID 不能改含义：可修正错别字、补翻译，但不能把"温度を設定する。修改"改成"风机モード修改"
5. 不再使用的 ID 保留占位：标记为废弃/Reserved/Deprecated，但不要削除
6. 新增内容只用新 ID：从没用过的 ID 往后追加
7. 不要依赖自动追加的ストリング·ストリング ID：直接填写的文字只适合当前版本界面表示，不适合作为履歴引用依据
8. アップグレード前チェックストリング·ストリング表兼容性：对比新旧版本，確認已发布 ID 含义没变
9. 建立ストリング·ストリング ID 维护表：记录每个 ID 的用途、英語と英語、有効ステータス、首次使用版本

整理自 广州大彩科技 VisualHMI 开发ドキュメント（hmi-doc.gz-dc.com）Resource Introduction「多言語（字库、文字タグ）」，著作権は大彩科技すべての。