GTweak 本地化架构拆解15 种语言 × 522 个键新语种接入零额外成本【免费下载链接】GTweakPortable Tool for an Ideal Windows Setup项目地址: https://gitcode.com/GitHub_Trending/gt/GTweakGTweak 是一个 Windows 优化工具内置 15 种语言的完整界面本地化。GTweak 本地化的多语言架构没有魔法全部是结构约束固定目录、注册文件、同步脚本三件套。读完你能拿走三样东西一套可直接套用的多语言目录结构区域变体命名的正确写法一条「先干跑再写盘」的翻译同步工作流。本地化资产全景多语言目录结构与文件职责GTweak 的多语言目录结构极简全部本地化资产集中在.Source/GTweak/Languages/一个目录其余代码只引用、不拥有它。.Source/GTweak/Languages/ ├── LanguageCatalog.xaml # 语言注册表15 条 ├── en/Localize.xaml # 英文基准522 键、16 个分区 ├── pt-BR/Localize.xaml # 巴西葡萄牙语 └── zh-CN/Localize.xaml # 简体中文共 15 个语言文件夹文件职责en/Localize.xaml英文基准所有翻译的参照系键的增删只发生在这里LanguageCatalog.xaml语言注册表决定语言选择器里出现哪些语言、显示什么名字{lang}/Localize.xaml每种语言一份只允许改值App.xaml.cs、GlobalOptions.cs运行时装配按语言代码拼 URI 加载对应 Localize.xaml装配逻辑在 App.xaml.cs 的 Language setter先拿系统 locale形如 zh-CN在 AvailableLangs 里精确匹配匹配不到就剥掉地区段只按语言代码匹配再不行落到英文另有一条特殊映射 be → ru白俄罗斯语借用俄语包。AvailableLangs 本身也是生成的GlobalOptions.cs 第 22 行把注册表 key 的下划线换成连字符后排序。语言选择器的条目完全由 LanguageCatalog.xaml 驱动没有第二份硬编码名单。区域变体命名规范文件夹名与注册 key 是两套规则区域变体BCP-47 风格就是「语言-地区」两段式写法最容易踩的坑在大小写和分隔符文件夹名和注册 key 各有一套规则混着用就是 bug。规则 1文件夹用「语言小写 连字符 地区大写」。 正确pt-BR/、zh-CN/。 错误pt-BR 写成 pt_BR/下划线是 key 的分隔符不是路径的或 ptbr/、pt-br/ 这种丢掉地区大小写区分的写法。规则 2注册 key 全小写、连字符变下划线。LanguageCatalog.xaml 文件头第 5–11 行的 NOTE 注释把这条写死了实际条目v:String x:Keypt_brPortuguês (BR)/v:String v:String x:Keyzh_cn简体中文 (CN)/v:String错误示例x:Keypt-BR。运行时 MainWinViewModel 按code.Replace(-, _)查表带连字符的 key 永远查不到界面直接回退显示语言代码本身。规则 3语言名用原生写法括号内附英文缩写——Português (BR)、简体中文 (CN)而不是 English Name (PT-BR) 这种机翻感命名。口诀路径带连字符、地区大写key 全小写、下划线连。翻译纪律Localize.xaml 的不可破规则522 个键的翻译文件只有四条规则破任何一条整个语言包都不可用。以 en/Localize.xaml522 键、16 个 #region 分区为样本规则 1红线只改尖括号里的值x:Key 一个字符都不许动。键是程序与界面之间的查找契约XAML 绑定按 key 取值改键等于断链界面要么空白要么回落英文。规则 216 个 #region 分区注释原样保留。文件按窗口切分Load Window、Main Window、Confidentiality Page、Packages Page 等分区让译者对着窗口逐段对照原文也让同步脚本能按 region 名做差异比对——删掉分区注释差异报告直接失效。规则 3键数与基准对齐 522。这是提交前最低成本的自检项同步脚本的 [/−] 报告也是以这个数为基准生成的。规则 4保留 XML 转义。基准里的 之类是 XAML 合法性的前提翻译时顺手「修正」成 会让整个资源字典加载失败522 个键全部作废。zh-CN 里的条目长这样键位与基准逐行对齐!--#region Message Window -- v:String x:Keytitle_message出错了.../v:String同步工具翻译同步脚本 LocalizeSync.cmd 的用法防止 15 种语言掉队的翻译同步脚本是 Tools/LocalizeSync.cmd。它是个多形态脚本前 8 行是 cmd 引导负责拉起 PowerShell第 9 行开始才是真正的 PowerShell 逻辑所以双击 .cmd 即可运行。脚本以 en/Localize.xaml 为基准-RefFile 可改-BasePath 缺省时向上遍历目录自动定位 Languages 文件夹。它做三件事审计 LanguageCatalog.xaml自动把不合规 key 规范化为小写下划线逐语言输出差异报告[] Keys added / [-] Keys deleted外加 region 增删正式写盘时以基准文件为结构模板把目标语言已有的值填回去缺失键在 -Placeholder 下补成空占位条目。参数一共 6 个真正该记住的是三个开关-DryRun只报告不写盘、-Backup写前复制 .bak、-Placeholder缺失键补空占位。推荐调用顺序LocalizeSync.cmd -DryRun # 第一步只看差异不动文件 LocalizeSync.cmd -Backup # 第二步正式同步先备份 LocalizeSync.cmd -DryRun # 第三步复查期望全部 No changes把「两次 DryRun 之间夹一次 Backup 写盘」固化成提交前流程误操作时 .bak 就是一键回滚。项目外围本地化README 的多语言文档组织多语言文档不该是本地化的边角料文档层是程序层的镜像。根目录放了 15 份同规格 README-*.mdREADME-pt-br.md、README-zh-cn.md 等命名沿用同一套区域变体规则主 README.md 顶部一排语言徽章链接到各份文档「Localization Translation」章节给出提交 PR 或提 Issue 两条贡献路径i18n 最佳实践里最容易被漏掉的文档层在这里补上了。迁移清单三步复刻这套 GTweak 本地化模式复刻这套 GTweak 本地化模式只需要三步顺序不能换。先定目录结构所有界面文案收敛进一个 Languages/ 目录英文文件是唯一基准UI 代码只按 key 引用、禁止硬编码文案。把命名规则写成注释文件夹大小写、key 的下划线规则、语言名格式集中写在注册文件头部的 NOTE 里GTweak 放在 LanguageCatalog.xaml 第 5–11 行让贡献者先读注释再动手。写一个以基准 diff 的同步脚本至少支持干跑报告、写前备份、缺失键补占位三个开关并把「先 DryRun 再写盘」写进贡献文档。做到这三步新增一种语言的成本就只剩「复制一个文件夹 翻译 522 个键 注册一行」——这正是 GTweak 本地化这套架构的全部收益。【免费下载链接】GTweakPortable Tool for an Ideal Windows Setup项目地址: https://gitcode.com/GitHub_Trending/gt/GTweak创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考