三亩地 三亩地SAN MU DI · CODE DIARY
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天,欢迎挑你感兴趣的翻一翻。

GitHub Desktop 汉化终极指南:用一款开源工具,5 分钟让英文界面彻底说中文

GitHub Desktop 汉化终极指南:用一款开源工具,5 分钟让英文界面彻底说中文

GitHub Desktop 汉化终极指南:用一款开源工具,5 分钟让英文界面彻底说中文

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

周五晚上九点,程序员小张又一次在 GitHub Desktop 的英文菜单里迷了路:他本想新建分支,鼠标却在 "Pull Request" 上悬停了五秒,最后误点了 "New repository"。这种场景,屏幕前的你是否也似曾相识?对绝大多数中文开发者来说,GitHub Desktop 汉化早已不是锦上添花的"可选优化",而是实实在在的刚需。好在,今天要介绍的GitHubDesktop2Chinese——一个开源的 GitHub Desktop 中文汉化工具,就是专为终结这种尴尬而生的。


一、先对号入座:这四类"英文界面之痛",你中了几个?

每次操作都要先在脑内做一次"英译中"的思维切换?这不是你英语不好,而是工具没替你想。中文用户使用 GitHub Desktop 的典型痛点,其实高度集中在四个方面:

  • 思维转换成本:点一个按钮要先反应半秒,积少成多,一天浪费十几分钟
  • 术语记忆负担:"Commit""Fetch""Rebase"……Git 术语还得额外背一套
  • 版本更新焦虑:官方每次更新,刚熟悉的界面又变了,学习成本反复归零
  • 团队协作门槛:新人上手时,工具本身的英文界面先劝退一波

这些痛点叠加起来,最终都指向同一个结论:工具应该迁就人,而不是人迁就工具。而 GitHubDesktop2Chinese 做的事情,恰恰就是把 GitHub Desktop 的界面文本批量替换为中文,让你把有限的注意力留给代码本身。


二、别急着装:先花 30 秒搞懂它凭什么能"扛住"频繁更新

可能你会好奇:GitHub Desktop 更新那么勤,汉化工具不会每次版本一升级就立刻失效吗?这正是这个项目的核心设计思路——它不依赖暴力破解,而是采用**"配置驱动"的文本映射机制**。

简单说,程序通过读取一份 JSON 映射文件,用正则表达式去匹配 GitHub Desktop 界面中的英文字符串,再替换成对应的中文。GitHub Desktop 哪怕又换了个版本,只要还有一两条文本没被覆盖,你手动往映射文件里补上一条即可,维护成本低得惊人,兼容性也因此非常出色。

💡 一句话概括:更新的是配置,不是程序。这是它相比传统汉化补丁最聪明的地方。


三、实操演示:从零到汉化成功的完整步骤

既然原理清楚了,就跟着我动手吧。整个过程大约 5 分钟,你只需要三个步骤。

步骤 1:获取汉化工具本体

两种方式任选其一:

  • 方式 A(推荐):克隆项目源码,随时同步最新改动
    git clone https://gitcode.com/gh_mirrors/gi/GitHubDesktop2Chinese
  • 方式 B:直接下载项目发布页的预编译可执行文件GitHubDesktop2Chinese.exe

步骤 2:确认运行环境

这是新手最容易踩坑的一步,请留个心眼。程序运行依赖Microsoft Visual C++ 运行库,如果双击后程序一闪而过,或者提示缺失MSVCP140_ATOMIC_WAIT.dll,多半就是运行库版本太旧了。

⚠️ 处理办法:下载并安装最新版Microsoft Visual C++ Redistributable(64 位系统选vc_redist.x64.exe,32 位选vc_redist.x86.exe)。装完还不行的话,检查程序所在目录是否残留了旧版MSVCP140.dllVCRUNTIME140.dll,如有请清理掉。另外,若提示找不到 openssl 相关 dll,直接更新到程序最新版即可。

步骤 3:运行汉化

GitHubDesktop2Chinese.exe双击运行,程序会自动完成一条龙操作:

  1. 通过 Windows 注册表自动定位GitHub Desktop 安装路径
  2. 读取汉化映射配置(可联网自动拉取最新版localization.json,也可将配置文件与 exe 放在同一文件夹手动指定)
  3. 自动备份原始文件,确保可回滚
  4. 执行精准替换,完成后给出汉化统计信息

记住一个关键结论:GitHub Desktop 每次更新后,都需要重新运行一次汉化程序。


四、配置文件大揭秘:localization.json 是如何"指挥"汉化的

如果说 exe 是执行者,那json/localization.json才是真正的灵魂。这个文件存储了 GitHub Desktop 中英文文本到中文文本的全部映射关系,结构清晰到你可以直接上手改。

核心节点速查表

节点类型职责
versionint配置文件版本号,仅当格式升级时才会变化
minversionstring所需的最低加载器版本,不满足时会提示
tiparray加载器中展示的通知提示信息
selectJSON汉化时的可选项(含replaceFiletooltipenablereplace四要素)
mainarray用于替换main.js的映射条目
main_devarraymain.js的开发调试用映射
rendererarray用于替换renderer.js的映射条目
renderer_devarrayrenderer.js的开发调试用映射

映射条目本身是成对的字符串数组,例如["&File", "文件(&F)"],前者是待匹配的英文原文,后者是替换后的中文。它支持正则表达式,所以哪怕官方代码里某个变量名随版本变了,也能靠正则模糊匹配兜底。

想加一条自己的翻译?三步搞定

  1. 打开json/localization.json,在mainrenderer数组里参照已有格式补一条
  2. 把配置文件放到程序目录下,重新运行程序
  3. 效果满意就保留,不满意就改,零风险

写映射时有三条铁律要记住:匹配文本里的双引号必须用反斜杠转义;正则中的特殊符号(?.*等)要在英文侧用双反斜杠转义,而替换后的中文文本里不能再带这些反斜杠;数组最后一个条目结尾不能有逗号,否则 JSON 会读不出来。


五、快问快答:关于汉化的 6 个高频疑问

Q1:汉化会影响 GitHub Desktop 的正常功能吗?会不会有风险?完全不会。汉化只替换界面显示文本,不碰任何核心功能代码。而且程序内置自动回滚机制,一旦替换过程出现异常,会自动恢复汉化前的原始文件,你随时可以手动还原,安全垫够厚。

Q2:汉化失败或想恢复原版怎么办?程序自动备份了原始文件。万一出问题,删掉汉化后的文件,让程序用备份自动恢复即可,不需要重装 GitHub Desktop。

Q3:GitHub Desktop 升级后需要重新汉化吗?需要。官方每次更新都可能改动界面文件,建议更新后立刻重跑一次汉化程序,几秒钟的事,换来的是一致的中文体验。

Q4:支持哪些操作系统?目前面向 Windows 平台,同时提供 64 位和 32 位两个版本,按你的系统选择即可。

Q5:程序打不开 / 一闪而过是什么原因?九成是缺少 VC++ 运行库,参考上文步骤 2 的解决方案。若提示 openssl dll 缺失,请升级程序到最新版。

Q6:我发现有句英文没被汉化,能自己补吗?当然能,这正是这个项目的开放之处。自己补一条映射并提交 PR,下一版所有用户都能受益。


六、进阶玩法:预览版、AI 摘要与开发者专属通道

基础汉化用顺了之后,这几个进阶功能值得你挨个试试。

玩法一:一键开启 GitHub Desktop 预览版功能

两种开启方式任选:

  • 环境变量法:在命令行执行
    set GITHUB_DESKTOP_PREVIEW_FEATURES=1
  • 加载器法:运行汉化程序时,按提示选择自动开启

玩法二:AI 提交摘要的完整适配

从 3.4.19 版本起代码层面已支持 AI 生成提交摘要,3.5.0 正式版则在前端界面默认显示。汉化映射已经把这些 AI 功能按钮和提示文案一并覆盖,你可以在中文界面里无障碍使用这一新特性。

玩法三:翻译者的高效调试通道

写了部分翻译想快速验证?把条目先放进main_devrenderer_dev,然后按住 Shift 键运行程序,勾选"仅替换指定映射项"——它只替换你新增的那几条,调试效率翻倍。验证无误后,把条目挪回mainrenderer数组末尾即可。


七、延伸阅读:它的技术底子与源码编译

看到这里,如果你对"这工具是怎么造出来的"感兴趣,这部分就是为你准备的。

技术栈一览

项目用 C++ 编写,构建系统是 CMake,依赖了一批口碑极佳的开源库:

  • CLI11:命令行参数解析
  • cpp-httplib:HTTP 网络请求
  • nlohmann/json:JSON 解析
  • spdlog:日志记录
  • WinReg:Windows 注册表操作

完整工作链路

  1. 注册表定位 GitHub Desktop 安装路径
  2. 读取 GitHub Desktop 最新版与本地版本并对比,有新版本会以醒目颜色提示
  3. 校验配置文件所需最低版本是否满足要求
  4. 备份原始文件
  5. 正则匹配并替换界面文本(支持选择性汉化)
  6. 校验替换结果并展示统计信息

此外它还内置了不少贴心细节:自动检测更新并支持一键更新、下载断点续传、支持系统 HTTP 代理(含环境变量与注册表读取),连 GitHub 访问不畅时的体验都考虑到了。

想自己编译一份?

克隆项目后,用Visual Studio 2022直接打开项目文件夹(CMake 会自动接管),构建生成可执行文件即可。源码结构非常清爽:主程序在GitHubDesktop2Chinese.cpp,工具函数收在Utils/utils.hpp,第三方库头文件集中在include/


八、独乐乐不如众乐乐:如何加入汉化贡献者行列

这个项目能持续跟上 GitHub Desktop 的更新节奏,靠的就是社区的力量。想贡献一份力量?路径很清晰:

  1. 克隆项目仓库
  2. 先读json/关于一些注意事项.txt,了解映射条目编写的坑与规范
  3. json/localization.json中参照既有格式补充汉化条目
  4. 放到程序目录实测通过后,提交 Pull Request

如果你发现某句翻译不准确或不够地道,同样欢迎提出来。开源项目的汉化质量,永远取决于参与的人有多少。


结语:把语言障碍留给工具,把效率留给自己

回到开头那个深夜写代码的小张——如果他的 GitHub Desktop 是中文界面,那个误点也许根本不会发生。GitHub Desktop 汉化的本质,从来不只是"看得懂",而是让你在版本控制的每一个动作里都更笃定、更高效。GitHubDesktop2Chinese 用一份配置文件加一个轻量程序,把这件事做到了极致简单。

马上动手试一次吧:克隆仓库、双击运行、5 分钟后收获一个全中文的 GitHub Desktop。你的 Git 操作,值得一次彻底的语言解放。🚀

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

← 返回列表