GitHub 中文化几分钟搞定：github-chinese 免费用户脚本安装与使用完整指南
项目地址: https://gitcode.com/gh_mirrors/gi/github-chinese github-chinese（GitHub 汉化插件）是一款免费开源的浏览器用户脚本，把 GitHub 网页的菜单、按钮、标题和提示就地换成中文，代码内容、文件名与议题正文一律不碰。装上 Tampermonkey 之类的脚本管理器后，几分钟内就能装好并验证效果，全程不需要注册账号，也不用改一行代码。
值不值得装：先做个快速判断
- 你主要靠浏览器看 GitHub（仓库页、议题、Pull Request）：装。中文界面就是最直接的好处，免费且无需账号。
- 你日常只走命令行或 API：收益接近于零，可以跳过。
- 浏览器能装脚本管理器才算数：Chrome/Chromium、Firefox、Safari 都支持（Tampermonkey、Violentmonkey 均可）；已经开了"整页翻译"扩展的，二者二选一，别叠加使用。
最短上手路径：从安装到生效
第 1 步：装好脚本管理器。 在浏览器扩展商店搜索并安装 Tampermonkey。Chrome 系浏览器还要到扩展管理页开启该扩展的"允许运行用户脚本"（通常需要同时打开开发者模式）。
- 应看到：工具栏出现管理器图标，扩展列表里显示已启用。
- 没生效就回查：扩展列表里是否真有这条安装记录；图标缺失多半是装失败，重装一次。
第 2 步：安装主脚本。 在浏览器中打开主脚本文件 main.user.js（开发版源），弹出确认页后点"安装"。两个版本可选：开发版源词库每周五自动更新，稳定版源 main(greasyfork).user.js.user.js) 每周一同步开发版词库，更保守，新手建议从稳定版开始。
- 应看到：管理器脚本列表出现"GitHub 中文化插件"条目，状态为"已启用"。
- 没生效就回查：没弹确认页说明管理器没跑起来，回第 1 步检查"允许运行用户脚本"开关；状态不是已启用，手动点一下启用。
第 3 步：强制刷新页面。 按 Ctrl+Shift+R（Mac 为 Cmd+Shift+R）绕过缓存刷新 GitHub 页面。
- 应看到：顶部导航栏、页面标题与按钮文字全部变中文。
- 没生效就回查：是否还有其他整页翻译扩展在抢先改写页面，停用后再刷新；再不行重启浏览器。
第 4 步（可选）：VS Code 集成浏览器。 按 vscode-extension/README.md 安装配套扩展，并给 VS Code 启动参数加上 --enable-proposed-api maboloshi.github-chinese（这是扩展调用浏览器 API 的必填项）。
- 应看到：集成浏览器里打开 GitHub 同样是中文界面。
- 没生效就回查：扩展是否启用、启动参数是否带上；两者缺一不可。
用起来之后：界面长什么样
仪表板首页的"主页""新建""置顶仓库""近期活动"等公共元素全部是中文，动态卡片里的相对时间也按本地习惯渲染，不用查字典就知道每个入口干什么。
把浏览器切成深色主题后，译文样式跟随主题一起变，深浅两种模式观感一致。
进阶调优：按自己的习惯改
- 记录漏译词条。 把 main.user.js 顶部配置里的
CONFIG.DEV改成true开启开发者模式，未命中词条会进入管理器，支持导出 JSON，方便你自己补词或提给社区。 - 翻译项目简介。 仓库页右侧"关于"面板里点"翻译"链接，英文项目描述会就地机器翻译成中文（走讯飞引擎），不改原仓库内容。
- 本地词库调试。 先克隆仓库
git clone https://gitcode.com/gh_mirrors/gi/github-chinese，把脚本里的@require在线词库地址改为file:///本地路径；仍无效时把 Tampermonkey 的"配置模式"切到"高级"，允许脚本访问本地文件。词库本体就是 locals.js 这个近 3 万行的文件，改词直接编辑它。 - 开关正则翻译。 脚本自带切换正则功能的菜单开关，临时关掉即可对比翻译前后效果，排查问题时用得上。
疑难答疑：现象、排查与解决
| 现象 | 先排查什么 | 解决办法 |
|---|---|---|
| 整页仍是英文 | "允许运行用户脚本"是否开启；有无整页翻译扩展抢占 | 开启开关、停用冲突扩展，再强制刷新 |
| 新页面部分区域未翻译 | GitHub 改版后的新元素是否还没进词库 | 更新脚本：开发版词库每周五更新，稳定版每周一同步 |
| 本地改词库没反应 | 脚本是否还在校验在线词库 | 把引用改为 file:// 本地路径；无效则 Tampermonkey 配置模式切"高级" |
| 顶部导航与搜索区不翻译 | 脚本版本号是否过旧 | 更新到 v1.9.4.4 及以上，该版本已恢复 React 搜索模块与下拉菜单的翻译 |
延伸阅读
- 项目说明、兼容环境与完整更新日志：README.md
- 脚本本体与词库：main.user.js、locals.js
- VS Code 扩展安装细节（含从源码构建）：vscode-extension/README.md
- 想参与贡献：直接编辑 locals.js 补充词条，或提改进代码的议题
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
