GTweak 本地化配置完整指南14 种语言区域变体 pt-BR 与 zh-CN 的正确写法【免费下载链接】GTweakPortable Tool for an Ideal Windows Setup项目地址: https://gitcode.com/GitHub_Trending/gt/GTweak先搞懂GTweak 的本地化为什么值得你研究GTweak 是一款绿色免安装的开源 Windows 优化工具它内置的 GTweak 本地化体系覆盖 14 种语言区域变体pt-BR、zh-CN、zh-TW各自独立维护、互不覆盖。本文写给想在 WPF / 桌面项目里做国际化、又不想从零搭架构的开发者下面按「目录组织 → 命名规则 → 翻译规范 → 同步机制 → 提交自查」的顺序把这套现成方案拆给你看。界面效果如上图所示——你看到的每一句文案都来自同一套语言资源文件。多语言目录怎么组织三件套职责拆解全部文案集中在.Source/GTweak/Languages/下结构一眼看穿.Source/GTweak/Languages/ ├── LanguageCatalog.xaml ← 语言注册表原生名称 缩写 ├── en/Localize.xaml ← 英文基准508 键 ├── pt-BR/Localize.xaml ← 巴西葡萄牙语 ├── zh-CN/Localize.xaml ← 简体中文 └── …fr、ko、ru 等共 12 个语言文件夹角色文件承担的职责翻译参照en/Localize.xaml英文原文508 个键其余语言都以它为标尺注册入口LanguageCatalog.xaml每种语言占一行原生写法 括号内英文缩写翻译载体zh-CN/Localize.xaml 等一语言一文件夹文件夹内一个Localize.xaml一句话点评新增一门语言的固定成本 复制一个文件夹 填写 508 条 注册一行。区域变体命名规则pt-BR / zh-CN 该怎么写GTweak 采用 BCP-47 风格的「语言-地区」写法三个要点语言代码全小写pt、zh地区代码全大写、用连字符连接BR、CN文件夹名混合大小写pt-BR、zh-CNzh-TW繁体中文单列一份绝不覆盖简体程序运行时会按地区精确匹配系统区域设置这正是变体必须分文件夹维护的原因。LanguageCatalog.xaml 顶部的 NOTE 注释写死了注册格式语言名用原生写法、括号附英文缩写key 一律小写、用下划线代替连字符——也就是pt-br必须写成pt_brv:String x:Keypt_brPortuguês (BR)/v:String !-- L20 -- v:String x:Keyzh_cn简体中文 (CN)/v:String !-- L25 --对应条目pt_brL20、zh_cnL25。⚠️ 最常踩的坑文件夹名与注册 key 的大小写规则正好相反——路径是「连字符 大写地区」pt-BRkey 是「全小写 下划线」pt_br。两处写混同步脚本就认不出这门语言。Localize.xaml 翻译的三个铁律每个Localize.xaml都是标准 XAML 资源字典条目长这样v:String x:Keybtn_changeChange/v:String翻译 Localize.xaml 时记住三条铁律键名一个字都不动修改条目时只碰引号里的文字x:Key的值是代码与界面之间的固定契约键一变绑定就断。分区注释原样保留文件用!--#region ... --按界面模块切出 15 个区域从Load Window到Toolset Page方便译者按窗口对照原文。条数必须对齐英文基准 508 键pt-BR、zh-CN也必须是 508 键——这是提交前第一道自检。用 LocalizeSync 同步脚本守住 14 种语言Tools/目录下的 LocalizeSync 同步脚本 以en/Localize.xaml为基准双击即可运行cmd 启动器包裹 PowerShell 逻辑对每个语言文件做三件事能力具体表现键名规范化把Btn-Change这类不规范键自动改写为小写下划线形式btn_change差异报告逐语言输出新增/删除的键[] Keys added/[-] Keys deleted及区域分区变化安全模式三个开关-DryRun只报告不写盘、-Backup写前留.bak备份、-Placeholder缺失键自动填空占位推荐工作流三步走先加-DryRun跑一遍确认差异清单里没有意外无异常后正式执行让脚本按基准顺序重排语言文件结构带上-Backup落盘万一误操作可凭.bak一键回滚。多语言 README 与贡献入口文档侧同样按区域变体拆分——根目录提供了 12 份同规格的语言 README巴西葡语README-pt-br.md简体中文README-zh-cn.md其余如README-fr.md、README-ko.md、README-ru.md等主 README.md 顶部的语言徽章直接链到对应文档「Localization Translation」章节给出 PR 与 Issue 两条贡献途径即使只翻译一两句文案新贡献者也知道从哪下笔。 提交前自检清单翻译提交前逐项打勾确认✅ 文件夹名为「语言-地区」格式pt-BR、zh-CN与 Windows 语言包代码一致✅LanguageCatalog.xaml中 key 为小写下划线pt_br、zh_cn语言名为原生写法✅Localize.xaml键名与英文基准逐一吻合引号内的值完成翻译✅#region分区注释完整保留条数与基准对齐508 键✅LocalizeSync的-DryRun模式跑过无未处理差异✅ 根目录对应语言的 README 已同步更新这套「统一目录 变体命名规范 脚本兜底 文档本地化」的组合把 14 种语言的维护成本压到了最低——你的多语言项目完全可以照此搭起来。【免费下载链接】GTweakPortable Tool for an Ideal Windows Setup项目地址: https://gitcode.com/GitHub_Trending/gt/GTweak创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/23 4:05:36 · 阅读 1.2k GTweak 本地化配置完整指南：14 种语言区域变体 pt-BR 与 zh-CN 的正确写法
GTweak 本地化配置完整指南14 种语言区域变体 pt-BR 与 zh-CN 的正确写法【免费下载链接】GTweakPortable Tool for an Ideal Windows Setup项目地址: https://gitcode.com/GitHub_Trending/gt/GTweak先搞懂GTweak 的本地化为什么值得你研究GTweak 是一款绿色免安装的开源 Windows 优化工具它内置的 GTweak 本地化体系覆盖 14 种语言区域变体pt-BR、zh-CN、zh-TW各自独立维护、互不覆盖。本文写给想在 WPF / 桌面项目里做国际化、又不想从零搭架构的开发者下面按「目录组织 → 命名规则 → 翻译规范 → 同步机制 → 提交自查」的顺序把这套现成方案拆给你看。界面效果如上图所示——你看到的每一句文案都来自同一套语言资源文件。多语言目录怎么组织三件套职责拆解全部文案集中在.Source/GTweak/Languages/下结构一眼看穿.Source/GTweak/Languages/ ├── LanguageCatalog.xaml ← 语言注册表原生名称 缩写 ├── en/Localize.xaml ← 英文基准508 键 ├── pt-BR/Localize.xaml ← 巴西葡萄牙语 ├── zh-CN/Localize.xaml ← 简体中文 └── …fr、ko、ru 等共 12 个语言文件夹角色文件承担的职责翻译参照en/Localize.xaml英文原文508 个键其余语言都以它为标尺注册入口LanguageCatalog.xaml每种语言占一行原生写法 括号内英文缩写翻译载体zh-CN/Localize.xaml 等一语言一文件夹文件夹内一个Localize.xaml一句话点评新增一门语言的固定成本 复制一个文件夹 填写 508 条 注册一行。区域变体命名规则pt-BR / zh-CN 该怎么写GTweak 采用 BCP-47 风格的「语言-地区」写法三个要点语言代码全小写pt、zh地区代码全大写、用连字符连接BR、CN文件夹名混合大小写pt-BR、zh-CNzh-TW繁体中文单列一份绝不覆盖简体程序运行时会按地区精确匹配系统区域设置这正是变体必须分文件夹维护的原因。LanguageCatalog.xaml 顶部的 NOTE 注释写死了注册格式语言名用原生写法、括号附英文缩写key 一律小写、用下划线代替连字符——也就是pt-br必须写成pt_brv:String x:Keypt_brPortuguês (BR)/v:String !-- L20 -- v:String x:Keyzh_cn简体中文 (CN)/v:String !-- L25 --对应条目pt_brL20、zh_cnL25。⚠️ 最常踩的坑文件夹名与注册 key 的大小写规则正好相反——路径是「连字符 大写地区」pt-BRkey 是「全小写 下划线」pt_br。两处写混同步脚本就认不出这门语言。Localize.xaml 翻译的三个铁律每个Localize.xaml都是标准 XAML 资源字典条目长这样v:String x:Keybtn_changeChange/v:String翻译 Localize.xaml 时记住三条铁律键名一个字都不动修改条目时只碰引号里的文字x:Key的值是代码与界面之间的固定契约键一变绑定就断。分区注释原样保留文件用!--#region ... --按界面模块切出 15 个区域从Load Window到Toolset Page方便译者按窗口对照原文。条数必须对齐英文基准 508 键pt-BR、zh-CN也必须是 508 键——这是提交前第一道自检。用 LocalizeSync 同步脚本守住 14 种语言Tools/目录下的 LocalizeSync 同步脚本 以en/Localize.xaml为基准双击即可运行cmd 启动器包裹 PowerShell 逻辑对每个语言文件做三件事能力具体表现键名规范化把Btn-Change这类不规范键自动改写为小写下划线形式btn_change差异报告逐语言输出新增/删除的键[] Keys added/[-] Keys deleted及区域分区变化安全模式三个开关-DryRun只报告不写盘、-Backup写前留.bak备份、-Placeholder缺失键自动填空占位推荐工作流三步走先加-DryRun跑一遍确认差异清单里没有意外无异常后正式执行让脚本按基准顺序重排语言文件结构带上-Backup落盘万一误操作可凭.bak一键回滚。多语言 README 与贡献入口文档侧同样按区域变体拆分——根目录提供了 12 份同规格的语言 README巴西葡语README-pt-br.md简体中文README-zh-cn.md其余如README-fr.md、README-ko.md、README-ru.md等主 README.md 顶部的语言徽章直接链到对应文档「Localization Translation」章节给出 PR 与 Issue 两条贡献途径即使只翻译一两句文案新贡献者也知道从哪下笔。 提交前自检清单翻译提交前逐项打勾确认✅ 文件夹名为「语言-地区」格式pt-BR、zh-CN与 Windows 语言包代码一致✅LanguageCatalog.xaml中 key 为小写下划线pt_br、zh_cn语言名为原生写法✅Localize.xaml键名与英文基准逐一吻合引号内的值完成翻译✅#region分区注释完整保留条数与基准对齐508 键✅LocalizeSync的-DryRun模式跑过无未处理差异✅ 根目录对应语言的 README 已同步更新这套「统一目录 变体命名规范 脚本兜底 文档本地化」的组合把 14 种语言的维护成本压到了最低——你的多语言项目完全可以照此搭起来。【免费下载链接】GTweakPortable Tool for an Ideal Windows Setup项目地址: https://gitcode.com/GitHub_Trending/gt/GTweak创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考