ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

我为什么把团队的GitHub Desktop全都换成了中文界面

我为什么把团队的GitHub Desktop全都换成了中文界面 我为什么把团队的GitHub Desktop全都换成了中文界面【免费下载链接】GitHubDesktop2ChineseGithubDesktop语言本地化(汉化)工具 【GitHub桌面客户端中文汉化】项目地址: https://gitcode.com/gh_mirrors/gi/GitHubDesktop2Chinese备选标题供编辑选择当GitHub Desktop撞上中文用户一个开源汉化工具让我彻底扔掉翻译软件我为什么把团队的GitHub Desktop全都换成了中文界面英文菜单背后的中文世界GitHub桌面客户端汉化全过程手记小周是我们组刚入职的应届生。第一次打开GitHub Desktop他盯着顶部菜单看了半分钟然后问我Stash all changes是干什么的。我解释完先把当前改动暂存起来他似懂非懂地点了点头接着手一抖点到了下面的Discard all changes。那一下午他重做了两个小时的工作。这不是他的问题。一个英文界面摆在一个中文用户面前出错几乎是必然的。而GitHubDesktop2Chinese这个专门做GitHub Desktop中文汉化的开源小工具就是用来解决这类问题的——它能把GitHub官方客户端GitHub桌面客户端的界面文本整体替换成中文不需要任何编程基础也完全不触碰你的代码和仓库数据。英文界面到底在制造多大的摩擦很多人觉得界面是英文将就一下也行但真实使用中摩擦远比想象中大日常高频操作——拉取Pull、推送Push、合并Merge、变基Rebase、暂存Stash——每个词都可能被误解弹窗和错误提示全是英文看不懂就不敢点确定生怕把提交搞坏团队里英语水平参差不齐有人把Fetch当成推送版本就乱了新同事入职第一天就要面对一堆英文术语学习成本直接翻倍。这些摩擦不会让GitHub Desktop用不了但会持续地消耗每个人的注意力和时间。换成中文界面之后这些成本几乎归零。为什么是改文本而不是等官方出中文你可能想问GitHub官方为什么不直接内置中文现实是GitHub Desktop至今没有官方的中文语言包等它出多语言版本遥遥无期。市面上的其他路子也各有短板方案优点致命问题用汉化破解版装完就能用安全性没保障官方一更新就失效手动改配置文件可控每次更新都要手动重来费时费力等官方多语言最正统目前根本没有时间表GitHubDesktop2Chinese文本替换安全、可回溯、更新友好需要每次GitHub Desktop更新后重跑一次这个工具选了一条很聪明的路GitHub Desktop的界面文字其实都打包在main.js和renderer.js两个文件里它做的事情就是用正则表达式把这些英文文本替换成中文。不注入、不破解、不动核心逻辑所以Git功能完全不受影响——就像给软件换了个皮肤。这种设计还有一个隐性的好处维护成本极低。哪怕GitHub Desktop某次更新后有个别词没翻译上也只需要在翻译文件里补一条映射即可不用推翻重做。翻译文件 localization.json 里到底存了什么汉化工具本身只是执行者真正的翻译内容都放在json/localization.json这个映射文件里。它的结构很清晰主要节点就几个节点作用version映射文件自身版本号minversion运行它所需的最低加载器版本tip加载时显示的通知信息main/main_dev用于替换main.js的映射后者是开发测试用的renderer/renderer_dev用于替换renderer.js的映射后者是开发测试用的select汉化时提示你进行选择性修改的开关项每条翻译本质上就是一个二维数组前一项是待匹配的英文支持正则后一项是替换成的中文。比如[File,文件(F)]就是把菜单栏的 File 改成文件同时保留快捷键。把汉化跑起来从下载到看到中文界面整个流程比我预想的简单得多不需要任何命令行操作先彻底退出GitHub Desktop。这一点最关键最好到任务管理器里确认进程已经结束否则文件被占用会替换失败。下载汉化程序。项目提供64位和32位两个版本按你的系统架构选一个即可。双击运行。程序会从注册表自动定位GitHub Desktop的安装目录不需要你手动去找app-版本号\resources\app这种深层路径。等它自动完成。程序会先备份原始文件生成main.js.bak和renderer.js.bak再执行替换最后验证写入结果。重新打开GitHub Desktop菜单、按钮、弹窗就都变成中文了。你甚至可以把localization.json单独下载下来放在程序同目录这样即使断网也能完成汉化。联网状态下程序还会自动拉取最新翻译文件并且支持断点续传。GitHub Desktop 一更新记得再跑一次这是使用这个工具最需要记住的一点每次GitHub Desktop更新后都要重新汉化一次。因为官方更新会把main.js和renderer.js覆盖回英文原版。好在工具已经把这个场景考虑进去了运行时会读取GitHub Desktop的最新版本号和本地版本对比发现有新版就用不同颜色提示你。如果真的在汉化过程中出了问题程序内置了自动恢复机制——它会在替换前保留备份出异常时从备份还原你也可以用--rollback参数手动回滚到汉化前的状态。进阶玩法开发者模式、预览版开关和AI提交摘要如果你不满足于装完即用这个工具还藏了几个好用的进阶功能按住Shift键启动程序会进入开发者模式可以只替换指定的某几条映射项——这是翻译贡献者调试新条目时的利器想快速验证某条翻译效果时特别好用。通过环境变量开启预览版功能。在命令行里执行set GITHUB_DESKTOP_PREVIEW_FEATURES1再启动GitHub Desktop就能解锁预览版选项如果嫌手动麻烦汉化时程序也会按提示询问你是否自动开启。AI生成提交摘要。从3.5.0版本开始GitHub Desktop前端界面已经支持AI生成提交摘要功能配合汉化工具提交时的中文提示也更顺手。遇到问题先别慌常见报错对照表我在测试过程中也踩过几个坑汇总成一张表供你对照排查现象常见原因处理方式提示缺少MSVCP140_ATOMIC_WAIT.dll系统缺少VC运行库安装最新版 Microsoft Visual C Redistributable按系统位数选 x64 或 x86 版本双击后程序一闪而过程序目录残留旧版运行库文件检查目录下是否有MSVCP140.dll、VCRUNTIME140.dll残留有则清掉汉化后主程序无法打开加载器版本过旧或JS内容有变动更新加载器到最新版执行GitHubDesktop2Chinese.exe dev --translationfrombak提示找不到GitHub Desktop注册表条目缺失或安装位置特殊用-g参数手动指定存放main.js的目录汉化后个别词还是英文新版本新增了未收录的文本属正常现象补一条映射或等翻译文件更新即可想自己动手补翻译比想象中简单这个项目最打动我的一点是翻译的准入门槛被压得很低。想参与的话只需克隆仓库git clone https://gitcode.com/gh_mirrors/gi/GitHubDesktop2Chinese先读json/关于一些注意事项.txt里面有完整的编写规范——比如双引号必须转义、正则特殊字符要用双反斜杠、数组最后一项不能有逗号等等参照已有格式在localization.json里添加翻译条目。不放心的话可以先把新条目放在main_dev或renderer_dev里按住Shift运行程序测试效果确认无误再移入正式数组提交PR。现在小周已经能自己完成提交、推送、切分支这些日常操作了再也没有因为看不懂界面而误删过改动。那天他跟我说早知道有这个工具第一天就该装。这句话其实适用于每一个被英文界面卡住的人。工具存在的意义就是去适应人的习惯而不是反过来。下载一个GitHubDesktop2Chinese关掉GitHub Desktop双击运行然后打开客户端看看——你的GitHub桌面客户端中文汉化从这一步就开始了。要是身边也有被英文界面困扰的同事不妨把这篇手记转给他。【免费下载链接】GitHubDesktop2ChineseGithubDesktop语言本地化(汉化)工具 【GitHub桌面客户端中文汉化】项目地址: https://gitcode.com/gh_mirrors/gi/GitHubDesktop2Chinese创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表