当前位置：首页 > news >正文

3分钟把 GitHub Desktop 变成全中文界面，这个开源汉化工具是怎么做到的？

news 2026/8/14 19:13:33

3分钟把 GitHub Desktop 变成全中文界面，这个开源汉化工具是怎么做到的？

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

周五晚上，你终于装好了 GitHub Desktop，打算把改了两周的课程作业推上去。界面确实清爽，可满屏英文让你心里发虚："Squash and merge"、"Stash all changes"、"Discard all changes"……每个单词都认识，拼在一起却不敢点。万一误操作，把辛辛苦苦写的代码搞没了怎么办？你在浏览器里搜"GitHub Desktop 中文版"，跳出来的不是过期的汉化补丁，就是只汉化了一半的教程帖。其实你要的不是一篇教程，而是一个能自己动手的工具——GitHubDesktop2Chinese就是干这个的：一个自动把 GitHub Desktop 界面文本替换成中文的本地化程序，核心只有一个小程序和一份 JSON 映射文件，双击运行，几分钟让整个客户端变中文。

一次完整实战：从英文界面到全中文，照着走就能跑通

先说明，这个工具只面向 Windows。整个汉化过程我实际走了一遍，比你想象的简单。

**第 1 步：把 GitHub Desktop 彻底关掉。**这一步千万别省，去任务管理器确认进程已经结束，否则文件被占用，替换会失败。

**第 2 步：准备程序和映射文件。**下载编译好的 GitHubDesktop2Chinese.exe（或者用 VS2022 打开项目、通过 CMake 自己构建一份）。把它和localization.json放在同一个文件夹里。如果你懒得单独下载 JSON 文件也没关系，程序找不到时会自动联网拉取最新版。

**第 3 步：双击运行。**你会发现它比你预期的"聪明"得多：

程序先通过注册表自动定位 GitHub Desktop 的安装目录，并读出你本地的版本号；
顺带联网查一下官方最新版，如果你本地版本偏旧，会用醒目的颜色提示你该更新了；
然后开始备份原文件——main.js会备份为main.js.bak，renderer.js同理；
最后按映射表逐条替换文本，全程有日志滚动输出。

GitHub Desktop 汉化工具的替换过程控制台输出

整个过程大概一两分钟，中间会提示你"按任意键继续"，别急着关窗口，按完流程走完会自动退出。

**第 4 步：重新启动 GitHub Desktop。**主菜单、提交按钮、分支管理、设置选项……都能看到中文了。如果哪次 GitHub Desktop 更新后又变回英文，不用慌——再运行一次汉化程序即可，日常也就三步：关客户端、跑程序、重开。

藏在细节里的设计：为什么它比普通"汉化补丁"更耐造

用完之后我特意翻了源码和项目文档，发现几个容易被忽略、却很见功力的细节。

**先备份、再动手，还留了一键后悔药。**程序只在备份文件不存在时才创建.bak，不会反复覆盖你最初的原始文件。万一汉化后觉得不对，用--rollback参数运行一次就能从备份还原。更贴心的是，如果某次操作中途异常导致main.js丢失，程序检测到.bak存在时会自动帮你恢复，而不是直接报错退出。

**用正则表达式对抗版本更新，这是它的灵魂设计。**GitHub Desktop 更新频繁，界面代码里的变量名常常变。所以localization.json里很多条目并不是死板地匹配固定字符串，而是用正则做模糊匹配，比如函数参数这种容易变的字符可以写成(..)通配，替换时再用#{1}这样的占位符把原文内容"搬"进中文文本里。这也是为什么它能做到"即便某两条翻译失效，手动补一下就行"，维护成本很低。

**按住 Shift 启动，直接进入开发者模式。**这是给翻译贡献者准备的彩蛋。Shift 模式下可以开启"翻译项失效检测"，把映射表里已经匹配不到原文的过期条目全部扫出来；还有"仅替换指定映射项"的功能，配合main_dev、renderer_dev两组开发条目，让你在提交前快速验证新翻译的效果，不用每次全量替换。想参与翻译的话，克隆仓库、读一下json/关于一些注意事项.txt里的编写规范，就能在localization.json里加条目了：

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

没有它 vs 有了它：差的不是"看懂"，是"敢点"

没用这个工具之前，很多人面对英文界面的真实状态是：功能会用的就那么几个，其他按钮不敢碰，全靠肌肉记忆。而汉化之后，界面语言一变，你才第一次注意到原来"Force Push"旁边还藏着"放弃所有更改"这种要命的功能，原来菜单里早就提供了"暂存所有更改"。

和那些打包好直接替换文件的"汉化补丁"比，差异也很明显：老式补丁绑定某个具体版本，GitHub Desktop 一升级就彻底报废；而 GitHubDesktop2Chinese 把翻译内容全部外置到 JSON 映射文件里，靠正则匹配生效，官方更新后即使个别条目失效，也只是局部"打补丁"的问题，而不是整个汉化失效。映射文件本身还会带上minversion版本校验，防止旧版程序加载新格式文件导致损坏。目前这份localization.json里已经躺着 900 多条中英映射，覆盖main.js和renderer.js两处核心资源。

新手最容易踩的三个坑，提前帮你避开

**坑一：没退出 GitHub Desktop 就跑汉化。**这是翻车率最高的操作。程序要改写的是客户端正在使用的 JS 文件，进程不关，要么替换失败，要么被系统占用。记住顺序：先关客户端，再跑汉化。

坑二：手改localization.json时踩中格式雷。如果你按教程自己加翻译条目，有三条红线别碰：数组最后一项结尾不要留逗号（JSON 解析直接报错）；匹配的双引号必须用反斜杠转义；遇到?这类正则特殊字符，要在它前面加两个反斜杠。另外匹配串建议带上双引号一起写，比如"\"&View\""，避免误伤到 "View on GitHub" 这种更长文本。

**坑三：双击程序没反应或一闪而过。**如果提示缺MSVCP140_ATOMIC_WAIT.dll，去装最新版的 Microsoft Visual C++ Redistributable 运行库就行，注意按自己系统的 64 位/32 位选择对应安装包。装完还不行的话，检查程序目录下有没有残留的MSVCP140.dll、VCRUNTIME140.dll之类的旧文件，有就清掉再试。