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 版本并对比你与官方最新版换版本也不慌提示清晰自动备份机制汉化前先把原始文件备份为main.js.bak、renderer.js.bak随时能一键还原英文原版异常自动恢复汉化中途出问题可执行恢复参数回到汉化前状态相当于内置了后悔药开源可定制汉化映射文件是纯 JSON谁都能看懂、谁都能改翻译不全时自己补一条就行它和你自己手动改文件最大的区别在于维护成本极低。GitHub Desktop 每次更新最多也就一两条翻译失效补上即可不需要每次都从头折腾。四、实战演示三步完成汉化全程不需要写一行代码开始前请先彻底关闭 GitHub Desktop包括右下角托盘图标里的进程这是最重要的准备动作。第一步拿到汉化工具二选一方式 A直接下载编译好的程序推荐大多数人到项目的发布页面下载最新的GitHubDesktop2Chinese.exe64 位系统用主程序32 位系统用带_x86后缀的版本。方式 B从源码自己构建如果你想看看它的实现或者想顺手改点什么可以克隆仓库后用 Visual Studio 2022 打开构建git clone https://gitcode.com/gh_mirrors/gi/GitHubDesktop2Chinese然后用 VS2022 直接打开项目文件夹项目使用 CMake生成解决方案即可。构建时程序会自动下载所需依赖库。第二步运行汉化程序跟着提示走双击GitHubDesktop2Chinese.exe程序会自动检测你的 GitHub Desktop 安装位置——这一步相当于自动导航定位它会通过注册表找到安装目录再定位到存放界面文字的资源文件夹。如果程序目录下没有localization.json它会自动联网获取最新版本的汉化映射文件网络不佳时它会提示你也可以自己手动把映射文件下载后放在程序同目录。看到main.js和renderer.js正在处理的提示时不要手动关闭窗口等它跑完自动退出。整个过程你会看到类似这样的输出正在读取GitHubDesktop最新版... 本地GitHubDesktop版本: 3.x.x 正在处理main.js文件,请勿关闭... main.js 文件汉化结束. 正在处理renderer.js文件,请勿关闭... renderer.js 文件汉化结束.小提示程序在开始时可能会显示按任意键继续那是提示你确认信息不是已经完成了请按提示往下走别中途关窗口。第三步重启 GitHub Desktop 验收成果重新打开 GitHub Desktop你会发现顶部的File、Edit、View菜单已经变成了文件编辑视图。这时候不要激动先点开几个关键功能确认一切正常具体检查清单见下一节。五、效果验证汉化前后的变化一眼看明白界面位置汉化前英文汉化后中文顶部菜单File/Edit/View/Repository文件(F) / 编辑(E) / 视图(V) / 存储库(R)新建入口New repository…新建存储库…克隆仓库Clone repository…克隆存储库…推送按钮Push/Force Push…推送 / 强制推送…拉取与同步Pull/Fetch拉取 / 同步分支操作Merge into current branch…合并到当前分支…提交相关Commit to main提交到主分支空状态引导Lets get started!让我们开始吧汉化完成后建议按这个清单快速验证一遍顶部菜单栏全部显示中文克隆 / 新建 / 添加本地仓库功能正常提交、推送、拉取按钮文字准确分支管理菜单新建、重命名、删除、合并可用设置页面选项可以正常打开六、进阶玩法从使用者变成定制者下面三个技巧能让你把这套汉化玩出花来而且全部安全可逆。技巧一开启 GitHub Desktop 的预览版功能GitHub Desktop 有些功能默认隐藏比如 3.5.0 版本新增的AI 生成提交摘要。你可以通过设置环境变量来开启set GITHUB_DESKTOP_PREVIEW_FEATURES1 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七、常见问题速查高频疑惑一次说清问题解决办法汉化后 GitHub Desktop 打不开了从备份恢复运行GitHubDesktop2Chinese.exe dev --translationfrombak程序会优先从备份文件重新处理想回到英文原版使用还原参数GitHubDesktop2Chinese.exe --rollback自动用.bak备份还原程序一闪而过 / 提示缺 DLL安装微软 Visual C 运行库64 位装vc_redist.x64.exe32 位装vc_redist.x86.exe再检查程序目录下是否残留了MSVCP140.dll之类的旧文件汉化不完整部分界面还是英文先确认 GitHub Desktop 版本与最新汉化映射是否匹配重新运行一次汉化程序或手动在localization.json里补充条目GitHub Desktop 更新后界面变回英文正常现象官方更新会覆盖界面文件重新运行一次汉化程序即可程序找不到 GitHub Desktop 的安装位置按提示手动指定存放main.js的目录安装目录下的resources\app文件夹八、你也可以参与让汉化质量越来越好这个项目是开源社区共同维护的翻译质量靠的就是大家的人肉校对。作为普通用户你能做的事情其实很简单发现问题就反馈遇到翻译不准、遗漏、错位的条目直接在项目里提 issues附上截图和版本号维护者就能快速定位。贡献翻译条目参照json/关于一些注意事项.txt的规范在localization.json里补上翻译先用开发模式测试通过再提交 Pull Request。顺手传播把这个工具推荐给身边被英文界面困扰的朋友就是最实在的支持。翻译这种事情一个人做不完美但几百个人每人补一条就接近完美了。项目维护成本之所以这么低靠的正是这条众人拾柴的路径。九、现在就去试试吧最后给你一份可以直接照做的行动清单关闭 GitHub Desktop下载最新版汉化程序双击运行跟着提示走到自动退出重新打开 GitHub Desktop对照上面的效果表验收遇到问题翻一翻上面的问题速查表发现翻译瑕疵提一条 issues 或补一条翻译工具是免费的操作是三分钟的事而你要做的只是迈出第一步。延伸阅读汉化映射文件json/localization.json、翻译编写规范json/关于一些注意事项.txt、主程序源码GitHubDesktop2Chinese.cpp。【免费下载链接】GitHubDesktop2ChineseGithubDesktop语言本地化(汉化)工具 【GitHub桌面客户端中文汉化】项目地址: https://gitcode.com/gh_mirrors/gi/GitHubDesktop2Chinese创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考