GitHub Desktop 至今没有官方中文界面。社区已有高质量翻译，但手动替换 main.js / renderer.js 的步骤对普通用户并不友好——于是我把这套流程做成了图形化工具：自动定位、一键汉化、自动备份、一键还原。

仓库地址：https://github.com/heylumen/github-desktop-zh

GitHub Desktop 汉化工具主界面

汉化原理

  1. GitHub Desktop 的界面文案以英文字符串字面量形式硬编码在打包后的 main.js（菜单 / 进程层）与 renderer.js（UI 层）中
  2. 上游 743859910/GitHub_Desktop_Simplified_Chinese（MIT License）已将这些文件整份翻译为中文（每个支持版本一份成品）
  3. 本工具按选定版本，将对应成品 main.js / renderer.js 整体替换到 GitHub Desktop 的 resources/app（先备份 .bak），100% 还原该版本官方级汉化
  4. 平台差异：__DARWIN__ 在 macOS 下使用另一套文案，故字典按平台分流（本工具内置 Windows 成品）

翻译内容完整源自上游 MIT 项目，已按条款保留其版权与许可声明。

功能特性

  • 🔍 自动定位 GitHub Desktop 安装目录（默认 %LOCALAPPDATA%\GitHubDesktop\app-*\resources\app），并自动识别已安装版本
  • ✅ 一键汉化：下拉选择版本（内置 3.6.0 – 3.6.4 共 5 个），自动备份原文件 .bak 后整体替换
  • ↩️ 一键还原：从 .bak 恢复英文原版
  • 📦 多版本内置：最新 5 个版本随 EXE 打包；旧版（3.5.0–3.5.9）可由本地 dictionaries/ 目录扩展
  • 🔎 校验内置版本：字典页一键校验 5 个内置版本的完整性
  • 🧩 自定义新版本：官方发布新版后，把字典目录放入 dictionaries/<版本>/ 即自动识别（本地优先于内置）
  • 🖥️ 同时提供命令行版 cli.py（脚本化 / 高级用户）

纯离线、不联网、不自动更新。

快速使用

桌面版 EXE（推荐普通用户）：

  1. 从 Releases 下载单文件 EXE（约 27MB），放到任意位置双击
  2. 首次运行：点「自动检测」填好路径 → 在「版本」下拉框选择与你的 GitHub Desktop 完全相同的版本号 → 点「应用汉化」
  3. 若 GitHub Desktop 装在需管理员权限的目录，右键「以管理员身份运行」本 EXE

命令行版：

1
2
3
4
python gui/cli.py locate                      # 自动检测安装目录
python gui/cli.py versions                    # 列出所有内置汉化版本
python gui/cli.py apply --version 3.6.4       # 应用指定版本汉化
python gui/cli.py restore                     # 还原为英文原版

自定义新版本（当官方发布内置未覆盖的新版，如 3.7.0）：

  1. 在 GitHub Desktop「帮助 → 关于」查看你的版本号
  2. 前往字典项目下载对应版本的 main.js + renderer.js
  3. 点工具「打开本地字典目录」，在 dictionaries/ 下新建与版本号一致的子目录（如 3.7.0），放入两个文件后重启程序
  4. 版本列表会出现该版本并标记「（本地）」，选中即可一键应用

技术栈与体积

Python + PySide6/Qt6（QSS 主题），PyInstaller onefile 打包。通过把最新 5 个版本字典随 EXE 一并打进单文件，产出的 EXE 约 27MB——相比原始字典裸打包体积缩减约一半。

免责声明

本项目与 GitHub, Inc. / Microsoft 无任何关联，非官方产品，未获其背书。所有修改仅作用于你本机已安装的 GitHub Desktop 文件，替换前自动备份 .bak，请自行承担使用风险。

欢迎提 Issue 反馈问题：https://github.com/heylumen/github-desktop-zh/issues