OpenCADStudio多语言支持揭秘：21种界面语言清单与中文本地化自定义方法

OpenCADStudio多语言支持揭秘21种界面语言清单与中文本地化自定义方法【免费下载链接】OpenCADStudioA CAD application built with Rust — 2D/3D drawing, DWG/DXF support, and GPU-accelerated rendering项目地址: https://gitcode.com/gh_mirrors/op/OpenCADStudioOpenCADStudio 是一款用 Rust 构建的免费开源 CAD 应用支持 2D/3D 绘图、DWG/DXF 读写和 GPU 加速渲染。它的多语言体系基于 Fluent 本地化框架内置21 种界面语言另加跟随系统选项简体中文开箱即用。本文将从普通用户视角拆解这套多语言机制完整语言清单、一键切换步骤以及如何在locales/目录里自定义中文本地化文本。 完整语言清单21种界面语言一览OpenCADStudio 的语言列表由 src/i18n.rs 中的Language枚举统一管理Language::ALL共 22 项 21 种语言 跟随系统对应翻译文件存放在locales/语言代码/opencadstudio.ftl。完整清单如下语言代码界面语言语言代码界面语言en-US英语源语言it-IT意大利语zh-CN简体中文fi-FI芬兰语zh-TW繁体中文hu-HU匈牙利语ja-JP日语pl-PL波兰语ko-KR韩语ru-RU俄语de-DE德语es-ES西班牙语fr-FR法语pt-BR巴西葡萄牙语nl-NL荷兰语bg-BG保加利亚语cs-CZ捷克语tr-TR土耳其语hi-IN印地语ar-SA阿拉伯语el-GR希腊语—— 细节选跟随系统时桌面端读取操作系统语言浏览器端读取浏览器的首选区域设置见 src/i18n.rs 的system_languages。找不到匹配语言时自动回退到英语回退策略由 i18n.toml 的fallback_language en-US指定。 最快切换中文界面选项窗口三步走普通用户切换到简体中文非常简单打开选项Options窗口找到「语言」区域标签为界面语言本地化文案见 locales/zh-CN/opencadstudio.ftl 的options.language-section在下拉框中选择简体中文设置即时生效——语言资源通过 Fluent loader 原子切换无需重启应用见 src/i18n.rs 的set_language。语言偏好会持久化保存src/app/settings.rs 的language字段重启后依然有效。注意语言切换只影响界面不影响图形文件内容DWG/DXF 中的标注文本保持原样。 中文本地化自定义方法编辑 Fluent 翻译文件想修改中文文案或补充缺失翻译所有翻译都是纯文本 Fluent 格式位于locales/zh-CN/opencadstudio.ftl共约 5900 行结构是「消息名 点属性」options .language-label 界面语言 .theme-label 应用程序主题本地化自定义的要点只改值不改键名每个语言文件必须与英语源目录的键一一对应cargo test --lib i18n::tests会校验各语言是否缺失或多余键、占位标记__ocs_arg_*、__ocs_fmt_*是否完整占位符要保留命令提示中的动态数值用__ocs_arg_name__标记传递翻译时把标记原样保留、只调整它所在的语序避免文件名、句柄等数据被翻译改完记得重新生成静态标签运行python3 scripts/export-locales.py刷新网页端和桌面打包的标签scripts/export-locales.py 会把 Fluent 目录导出为web/locale-labels.json、桌面菜单.desktop的 Comment/Keywords 以及 Windows 安装包字符串再用python3 scripts/test_site.py验证。新增一门语言则只需在locales/下按 BCP-47 命名建目录如xx-XX/opencadstudio.ftl并在 src/i18n.rs 的Language枚举与Language::ALL中登记。 多语言机制速览Fluent i18n-embed 是怎么工作的整套多语言管线由三层构成理解它有助于排查问题资源嵌入层locales/整个目录通过RustEmbed编译进二进制src/i18n.rs桌面版和网页版wasm共用同一套翻译加载层i18n_embed的FluentLanguageLoader按请求语言 → 系统偏好 → en-US 回退的顺序加载浏览器端还会把页面lang属性设成所选语言阿拉伯语自动切换为 RTL 右到左排版src/i18n.rs翻译层界面代码通过tr!/t!/tf!三个宏取词其中tf!对应 Rust 的format!能在本地化句子中正确还原数字、文件名等渲染值src/i18n.rs。相关模块路径速查翻译目录locales/zh-CN/opencadstudio.ftl中文、locales/en-US/opencadstudio.ftl英语源目录语言框架配置i18n.toml核心实现src/i18n.rs标签导出脚本scripts/export-locales.py多语言 READMEdocs/readme/README.zh-CN.md✅ 小结OpenCADStudio 的多语言支持可以概括为21 种语言开箱即用、选项窗口一键切换、Fluent 纯文本可自定义。中文用户直接选简体中文即可想深度定制文案改locales/zh-CN/opencadstudio.ftl后跑一遍导出脚本就完成了一个完整的中文本地化闭环。【免费下载链接】OpenCADStudioA CAD application built with Rust — 2D/3D drawing, DWG/DXF support, and GPU-accelerated rendering项目地址: https://gitcode.com/gh_mirrors/op/OpenCADStudio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考