GitHub Desktop 汉化终极上手：3 分钟一键变中文，看不懂英文也能放心提交代码

【免费下载链接】GitHubDesktop2ChineseGithubDesktop语言本地化(汉化)工具 【GitHub桌面客户端中文汉化】项目地址: https://gitcode.com/gh_mirrors/gi/GitHubDesktop2Chinese

这篇文章要介绍的开源项目是GitHubDesktop2Chinese——一个专门给 GitHub Desktop 桌面客户端做语言本地化（汉化）的小工具。它会自动找到你电脑上安装的 GitHub Desktop，把界面里的英文菜单、按钮、提示全部替换成中文，全程只需几分钟，不需要任何编程基础。

一、先讲一个真实发生的"社死"瞬间

程序员小陈，入职第三个月。周一的早上，他端着咖啡，准备把昨晚写完的分支推到远程仓库。屏幕上满屏英文，他看到一个写着"Force Push"的按钮，当时心里想：这不就是"推送"嘛，点了应该没事。

于是，整个团队的远程分支历史，被他一个点击彻底改写了。那天的群消息，小陈至今不敢翻。

你可能觉得这事有点夸张，但真正用过 GitHub Desktop 英文版的人都知道，那种"盯着菜单半天不敢点"的感觉有多真实。GitHub Desktop 官方迟迟没有中文界面，而 GitHubDesktop2Chinese 这个开源工具的出现，就是想让中文用户不必在"看英文"和"用 Git"之间二选一。

二、在中文界面这件事上，谁吃过亏？

新手：每一步都像在走钢丝

• 看到Push和Fetch，分不清哪个是"推上去"、哪个是"拉下来"
• 提交代码前反复核对，生怕点错一个按钮
• 合并分支时弹出英文警告，只能截图发给别人帮忙翻译
• 学习 Git 本身已经够难了，还要顺带学英语

进阶用户：快，但还不够快

• 明明操作很熟练，看到英文还是要在脑子里"翻译一遍"再执行
• Squash and merge、Rebase这类术语，每次都要确认含义
• 偶尔误点了Discard all changes，才发现自己亲手丢掉了半天的改动

团队与教学场景：语言不统一，沟通全靠猜

• 团队里有人用中文版截图问问题，有人用英文版回答，双方对不上号
• 教学时老师要花时间解释界面英文，而不是讲 Git 本身
• 新人培训成本被界面语言硬生生拉高了一截

如果你在以上任何一条里看到了自己，那接下来的内容就是为你准备的。

三、它到底是什么？一台"自动翻译机"加一个"后悔药保险柜"

GitHubDesktop2Chinese 的原理其实不复杂，可以这样理解：

GitHub Desktop 的界面文字，都存放在它安装目录下的两个文件里（main.js和renderer.js）。这个工具做的事情，就是拿着localization.json里的"中英对照表"，用正则匹配的方式，把文件里的英文文本精准替换成中文。

就像你在 Word 里用"查找替换"把所有"Hello"改成"你好"，只不过它做得更聪明、更安全，而且是全自动的。

它和你自己手动改文件最大的区别在于：维护成本极低。GitHub Desktop 每次更新，最多也就一两条翻译失效，补上即可，不需要每次都从头折腾。

四、实战演示：三步完成汉化，全程不需要写一行代码

开始前，请先彻底关闭 GitHub Desktop（包括右下角托盘图标里的进程），这是最重要的准备动作。

第一步：拿到汉化工具，二选一

方式 A：直接下载编译好的程序（推荐大多数人）

到项目的发布页面下载最新的GitHubDesktop2Chinese.exe，64 位系统用主程序，32 位系统用带_x86后缀的版本。

方式 B：从源码自己构建

如果你想看看它的实现，或者想顺手改点什么，可以克隆仓库后用 Visual Studio 2022 打开构建：

git clone https://gitcode.com/gh_mirrors/gi/GitHubDesktop2Chinese

然后用 VS2022 直接打开项目文件夹（项目使用 CMake），生成解决方案即可。构建时程序会自动下载所需依赖库。

第二步：运行汉化程序，跟着提示走

1. 双击GitHubDesktop2Chinese.exe，程序会自动检测你的 GitHub Desktop 安装位置——这一步相当于"自动导航定位"，它会通过注册表找到安装目录，再定位到存放界面文字的资源文件夹。
2. 如果程序目录下没有localization.json，它会自动联网获取最新版本的汉化映射文件（网络不佳时它会提示你，也可以自己手动把映射文件下载后放在程序同目录）。
3. 看到main.js和renderer.js正在处理的提示时，不要手动关闭窗口，等它跑完自动退出。

整个过程你会看到类似这样的输出：

正在读取GitHubDesktop最新版... 本地GitHubDesktop版本: 3.x.x 正在处理main.js文件,请勿关闭... main.js 文件汉化结束. 正在处理renderer.js文件,请勿关闭... renderer.js 文件汉化结束.

小提示：程序在开始时可能会显示"按任意键继续"，那是提示你确认信息，不是"已经完成了"，请按提示往下走，别中途关窗口。

第三步：重启 GitHub Desktop 验收成果

重新打开 GitHub Desktop，你会发现顶部的File、Edit、View菜单，已经变成了"文件""编辑""视图"。这时候不要激动，先点开几个关键功能确认一切正常（具体检查清单见下一节）。

五、效果验证：汉化前后的变化，一眼看明白

汉化完成后，建议按这个清单快速验证一遍：

• 顶部菜单栏全部显示中文
• 克隆 / 新建 / 添加本地仓库功能正常
• 提交、推送、拉取按钮文字准确
• 分支管理菜单（新建、重命名、删除、合并）可用
• 设置页面（选项）可以正常打开

六、进阶玩法：从"使用者"变成"定制者"

下面三个技巧，能让你把这套汉化玩出花来，而且全部安全可逆。

技巧一：开启 GitHub Desktop 的"预览版功能"

GitHub Desktop 有些功能默认隐藏，比如 3.5.0 版本新增的AI 生成提交摘要。你可以通过设置环境变量来开启：

set GITHUB_DESKTOP_PREVIEW_FEATURES=1 "GitHub Desktop.lnk"

也可以不手动操作——汉化程序运行时会询问你是否强制开启预览版选项对应的功能，跟着提示选择即可。

技巧二：自己动手补一条翻译

汉化映射文件是localization.json，格式就是"中英对照"的二维数组：

["英文原文", "中文翻译"]

例如：

["&File", "文件(&F)"], ["Clone repository…", "克隆存储库…"]

如果你发现某个按钮还是英文，照着这个格式在对应数组里补一条就行。注意写完后 JSON 里最后一项不能有逗号，否则程序无法读取。更详细的编写规范（比如双引号要转义、正则特殊符号的处理），项目里的json/关于一些注意事项.txt写得非常清楚。

技巧三：用开发模式安全测试自己的翻译

自己写的新条目，别急着直接合并进正式区域。先放在main_dev或renderer_dev数组里，然后按住 Shift 键启动程序，进入开发者模式，选择"仅替换指定映射项"，这样只会替换你新加的条目，测试效果又快又安全。

测试通过后，再把条目挪到main或renderer数组末尾即可。如果 GitHub Desktop 更新后翻译失效，还能用开发者模式里的"失效检测"功能，一键找出所有匹配不上的条目：

GitHubDesktop2Chinese.exe dev --invalidcheck

七、常见问题速查：高频疑惑一次说清

八、你也可以参与：让汉化质量越来越好

这个项目是开源社区共同维护的，翻译质量靠的就是大家的"人肉校对"。作为普通用户，你能做的事情其实很简单：

1. 发现问题就反馈：遇到翻译不准、遗漏、错位的条目，直接在项目里提 issues，附上截图和版本号，维护者就能快速定位。
2. 贡献翻译条目：参照json/关于一些注意事项.txt的规范，在localization.json里补上翻译，先用开发模式测试通过，再提交 Pull Request。
3. 顺手传播：把这个工具推荐给身边被英文界面困扰的朋友，就是最实在的支持。

翻译这种事情，一个人做不完美，但几百个人每人补一条，就接近完美了。项目维护成本之所以这么低，靠的正是这条"众人拾柴"的路径。

九、现在就去试试吧

最后，给你一份可以直接照做的行动清单：

• 关闭 GitHub Desktop，下载最新版汉化程序
• 双击运行，跟着提示走到自动退出
• 重新打开 GitHub Desktop，对照上面的效果表验收
• 遇到问题，翻一翻上面的问题速查表
• 发现翻译瑕疵，提一条 issues 或补一条翻译

工具是免费的，操作是三分钟的事，而你要做的，只是迈出第一步。

延伸阅读：汉化映射文件json/localization.json、翻译编写规范json/关于一些注意事项.txt、主程序源码GitHubDesktop2Chinese.cpp。

【免费下载链接】GitHubDesktop2ChineseGithubDesktop语言本地化(汉化)工具 【GitHub桌面客户端中文汉化】项目地址: https://gitcode.com/gh_mirrors/gi/GitHubDesktop2Chinese