先说我自己的情况我现在浏览GitHub默认就是中文界面。不是改了什么系统语言也不是换了客户端纯粹是靠一个浏览器插件配合一段脚本完成的。这几年我身边越来越多同事、学员开始问GitHub中文化的问题原因很简单——英文界面能凑合用但遇到Issues里一大段讨论、Settings里密密麻麻的选项时母语阅读速度带来的优势太明显了。这篇教程就把我现在用的这套GitHub中文界面插件安装方案完整拆开讲一遍从选型、安装、配置到排错都覆盖到全程跟着做5分钟就能把GitHub全界面中文化搞定不需要动系统文件也不会影响你仓库里的任何代码。适合英语基础一般、想快速上手GitHub的初学者也适合已经在用、但想让界面更顺眼的老手。1. 先说清楚GitHub没有官方中文浏览器脚本才是最优解1.1 为什么GitHub迟迟不提供中文语言包很多人第一次找GitHub的中文设置时都会先去头像菜单、Settings、Appearance里翻一遍结果发现压根没有Language选项。这不是你不会找是GitHub官方确实没做。GitHub在全球开发者社区里的定位比较特殊它的产品语言长期以英文为主部分页面会跟随浏览器语言做一些本地化适配但覆盖范围非常有限。官方讨论区里关于提供更多语言界面的诉求提了很多年始终没有得到明确的排期承诺。原因不难理解GitHub界面上高频出现的术语像Repository、Pull request、Issue在英文原文里已经形成了全球通用的语义一旦翻译成不同语言反而容易在协作中产生理解偏差。加上GitHub前端更新节奏很快维护一套完整的国际化语言包成本并不低。这就意味着在可预见的未来想用上中文界面基本只能靠社区方案。我们不是在等官方而是要在官方没有提供语言切换按钮的前提下自己解决问题。1.2 三种常见中文化方案的实测对比围绕GitHub中文化目前社区里主要流传着三类方案独立翻译扩展、第三方GitHub客户端、浏览器脚本。我把它们放在一起做了对比方案类型覆盖范围更新速度对使用习惯的影响上手难度风险浏览器脚本油猴覆盖仓库页、Issues、PR、个人主页、设置等主要界面社区维护跟随GitHub更新较快最小原界面布局不变低装完即用低仅本地替换文本独立翻译扩展部分覆盖翻译颗粒度不可控依赖扩展作者维护可能误翻网页内的代码片段低中可能影响其他网站第三方GitHub客户端只覆盖客户端自己的界面取决于客户端版本需要改变日常工作流中中需要处理账号认证我身边用下来最终稳定的基本都是第一种。独立翻译扩展的问题在于它往往是一种顺带翻译的逻辑经常把代码块里的字符串也一起替换掉造成误导。第三方客户端则属于另一个使用场景不适合大多数只是在网页上阅读、审阅代码的人。1.3 汉化插件到底在做什么运行时替换与安全边界理解了选型再来说说这类脚本的工作原理。GitHub中文界面插件本质上维护了一份英文原词 → 中文译词的映射字典脚本在页面加载完成后会遍历界面上的文本节点把命中字典的英文文本替换成中文。整个过程发生在浏览器本地不涉及GitHub服务端的数据修改。有个边界必须说清楚它只翻译界面元素不翻译仓库代码、不翻译文件内容、不翻译commit信息、也不会改你的issue正文和评论。也就是说你仓库里的代码该是什么样还是什么样项目README里的英文文档也不会被翻译。这个特性很重要——如果你是团队协作者别人看到的依然是原始内容汉化只发生在你自己的浏览器视图里。安全性方面只要确认安装的是开源社区维护的脚本、来源可靠就不会有请求外部服务的动作翻译词典也存在本地。装完之后如果不放心可以在浏览器开发者工具里查看网络请求如果脚本没有向陌生域名发送数据基本可以放心用。这也是我坚持推荐脚本方案而不是乱装GitHub中文版安装包类软件的原因。2. 安装前把这三样东西准备好浏览器、脚本管理器、汉化脚本2.1 脚本管理器Tampermonkey为什么选它以及正确安装姿势前面提到的浏览器脚本需要一个脚本管理器来承载运行。目前最主流、兼容性最好的是Tampermonkey中文圈习惯叫油猴。它支持Chrome、Edge、Firefox、Safari等主流浏览器安装一个就能管理后续所有用户脚本。安装Tampermonkey的路径很简单打开你浏览器的扩展商店搜索Tampermonkey认准发布者为Tampermonkey.net或扩展评分很高、安装量很大的那一个点击添加即可。Chrome用户去Chrome网上应用店Edge用户去Microsoft Edge加载项Firefox用户去Firefox Add-ons。安装完成后浏览器右上角会出现一个黑白相间的扩展图标说明已经就绪。这里有一个容易踩的坑有些浏览器在安装第三方扩展时会默认关闭开发者模式或者弹窗提示此扩展会影响网页浏览体验你需要手动允许。如果图标没出现去浏览器的扩展管理页面确认它是已启用状态。装好之后建议先把浏览器其他同类型脚本管理器卸掉比如Violentmonkey和Tampermonkey同时开虽然不一定会冲突但排查问题时会多一个变量。2.2 汉化脚本去哪里找用户脚本市场与开源项目脚本管理器装好之后接下来要装的是汉化脚本本体。这类脚本通常托管在用户脚本社区GreasyFork上国内也有镜像站点不过直接用GreasyFork原站即可。打开GreasyFork在搜索框输入GitHub 中文或GitHub 汉化会出现多个候选脚本。选择标准我给自己定了三条安装量高、最近还在更新、脚本描述里放出了完整源码仓库地址。安装量高说明经过大量用户验证最近更新说明作者还活着会跟进GitHub前端变化源码仓库则是安全性的保障。我自己用的这个脚本作者把字典文件做成了可配置格式安装后会在GitHub页面右上角生成一个菜单按钮支持一键切换中英文、手动添加翻译词条。这样的设计对我很有用因为默认翻译在某些场景下并不完全符合我的表达习惯。2.3 安装过程中的权限提示如何选择从GreasyFork安装脚本时Tampermonkey会弹出一个安装确认页上面列出了脚本的元信息、权限范围和代码内容。很多新手看到一堆英文直接点安装这没问题但如果你在意权限边界这里是值得花30秒看一眼的。GitHub汉化脚本一般会请求https://github.com/*和https://gist.github.com/*这两个域的访问权限前者覆盖主站所有页面后者覆盖代码片段页面。这个范围是合理的因为汉化需要读取页面文本没有这个权限脚本根本跑不起来。有些脚本还会声明grant none表示不申请额外的浏览器高级权限这种更清爽。如果你对权限比较敏感可以安装后手动打开Tampermonkey管理面板在脚本设置选项卡里调整match规则只保留https://github.com/*一条。无非是Gist页面不再汉化但主站体验不受影响。2.4 装好之后先别急着用快速验证脚本是否被浏览器加载经常有人装完脚本打开GitHub发现还是英文第一反应是脚本坏了。其实很多时候只是脚本根本没被加载。装完之后建议先做一个快速验证打开GitHub任意页面在页面右键选择检查切到Console标签刷新页面。如果脚本正常执行Console里通常会出现脚本运行日志、版本号或者页面右上角出现汉化插件自己的悬浮按钮/菜单图标。Tampermonkey面板里也会显示该脚本的最后运行时间。如果没有这些痕迹优先检查两件事Tampermonkey扩展是否被浏览器禁用脚本是否处于启用状态。很多浏览器在安装新扩展后会在新标签页里自动禁用部分扩展的域名访问权限需要你在扩展详情页手动打开允许访问所有网站或者至少允许GitHub域名。3. 5分钟实操流程从下载插件到全界面显示中文3.1 第1分钟给浏览器装上脚本管理器这一分钟的动作看似简单但很多人会卡在不知道去哪儿下载结果搜了一堆山寨软件站。记住不要从第三方软件站下载任何浏览器扩展安装包直接在浏览器内置的应用商店里搜索即可。以Edge为例点击右上角三个点 → 扩展 → 打开Microsoft Edge加载项。在搜索框输入Tampermonkey选择扩展名为Tampermonkey、安装量在几百万以上的那一个点击获取后弹出权限确认点击添加扩展。Chrome同理在Chrome网上应用店操作。装好后确认右上角出现了油猴图标。如果没出现去浏览器扩展管理页把它固定到工具栏后面操作会顺手很多。这一分钟结束时你手里就有了一块能运行脚本的地基。3.2 第2-3分钟搜索并安装GitHub汉化脚本浏览器地址栏直接访问GreasyFork顶部搜索框输入GitHub 中文。搜索结果里通常会有好几个脚本关键是别闭眼装第一个。我会先点开每个脚本的详情页看几个信息点最近更新日期超过半年没更新的脚本遇到GitHub改版大概率失效。安装量/每日安装数据量大的脚本说明采集到的bug反馈更多、成熟度更高。作者主页或源码链接点进去确认是真实的开源项目、有完整字典文件而不是一个压缩混淆后的黑盒脚本。确定一个顺眼的脚本后点击页面右上角绿色的安装此脚本按钮Tampermonkey会接管并弹出安装确认页。确认页里可以看到脚本的match是否覆盖github.com、name是否是你要装的汉化脚本。点击安装结束。3.3 第4分钟刷新GitHub并逐页面核对汉化效果脚本装好之后打开一个新的GitHub标签页或者对已有页面做一次强制刷新。我建议不要直接刷新正在看的旧页面而是重新打开一次https://github.com首页或者任意仓库页面排除旧页面缓存干扰。刷新完成后大部分界面文本应该已经变成中文。为了确认全界面这个目标我习惯按下面这个清单逐项核对检查点预期中文效果如果还是英文仓库文件列表文件名上方工具条显示代码Issues拉取请求等检查脚本是否启用单个文件页面原始文件复制下载追溯等按钮为中文强制刷新页面Issues列表过滤器、状态标签为中文Issues标题保持原文等待1-2秒后重新切页个人主页概览仓库项目包等Tab为中文确认匹配规则包含用户主页层级设置页面个人资料账户外观等侧边栏为中文核对脚本字典是否含设置页词条这里要注意一个认知GitHub的Issues标题、PR标题、代码内容、仓库名、文件内容都是用户数据脚本会刻意跳过不翻。你看到Issue列表是中文的但标题是英文是正常现象不是没生效。3.4 第5分钟按需调整脚本的中英文开关和匹配范围大部分汉化脚本安装后默认就是开启状态不需要再做配置。但我建议你花这一分钟做两件小事能省掉后面很多麻烦。第一件找到脚本在GitHub页面上的入口。多数脚本会把入口做成右上角的一个悬浮按钮或者Tampermonkey菜单里多出一个一行文字。点开看看有没有启用/停用翻译重新加载词典中英文对照之类的选项。平时不需要切换就不用管但出问题时这个入口能帮你快速定位。第二件打开Tampermonkey管理面板确认脚本的匹配规则match确实包含https://github.com/*。很多脚本默认只匹配了https://github.com/*如果你自己修改过或者安装的版本太老可能漏掉Gist或者其他子域名。可以改为下面这种更稳妥的写法// UserScript // name GitHub 中文汉化示例 // namespace http://tampermonkey.net/ // match https://github.com/* // match https://gist.github.com/* // run-at document-idle // grant none // /UserScript改完match之后必须点击保存并关闭再刷新GitHub页面才能生效。4. 安装完没生效按这几个方向排查4.1 最基础的三件事插件启用、脚本启用、缓存清理之前帮人排查过太多次装完没反应的问题九成以上都栽在这三件小事上而且一个比一个低级但常见。第一浏览器扩展是否真的启用了。有些浏览器为了省资源会自动休眠长时间不用的扩展。去扩展管理页看一眼Tampermonkey开关是蓝色/打开的而不是灰色。第二脚本是否处于启用状态。Tampermonkey面板里脚本行首的开关如果被关了脚本不会运行。第三浏览器缓存和Service Worker缓存。GitHub是重度前端应用旧的JS和CSS文件可能还是英文版本的界面结构导致脚本注入时匹配规则对不上。清缓存的方式是CtrlShiftR强制刷新如果还不行打开开发者工具的Application面板Clear site data后再刷新。这三件事如果都勾掉了再看下面的深入原因。4.2 匹配规则和页面覆盖范围为什么有的页面翻了有的没翻一个非常典型的场景是仓库详情页的中文化效果很好但点进个人主页或者某些二级页面又变回英文。排查思路一定绕不开匹配规则。脚本的match表达式决定它在哪些URL上运行。如果你遇到仓库页生效、个人主页不生效的问题先打开Tampermonkey面板看脚本的匹配范围。https://github.com/*的*代表路径段的通配严格来说它能匹配github.com/用户名和github.com/用户名/仓库名这两类路径。但如果脚本作者写的是https://github.com/*/*这样的两级匹配在某些路由结构下会漏掉用户主页。我自己习惯统一改成https://github.com/*配https://gist.github.com/*两个规则覆盖范围最稳妥。还有一种情况GitHub的页面路由是按下History API实现的脚本如果只在初始页面加载时执行一次你在站内点击链接跳转到其他页面时新页面可能没被及时翻译。遇到这种情况需要脚本监听urlchange事件。如果当前脚本没有这个能力只能手动刷新页面或者换一个支持SPA路由监听的脚本。4.3 动态渲染造成的半中半英状态为什么偶尔要等一下GitHub页面大量使用异步渲染很多区域的内容是在页面框架加载完成后才通过接口拉取并填充的。这也导致汉化脚本不是唰的一下把所有文字一次性替换完而是先翻译完第一批DOM节点再等动态内容插入后翻译第二批中间会出现短暂的半中半英窗口。如果你在切换页面或刷新后立刻截图、立刻操作看到一部分英文完全是正常的。通常等待1到2秒脚本的MutationObserver监听到新增DOM后会补上翻译。如果等了很久还是英文可以用鼠标在英文区域悬停一下或者滚动页面触发重新渲染再看是否恢复。这个问题不是bug而是这类脚本的通用工作机制。要不是这么做脚本就必须在GitHub服务端动手脚那就不现实了。理解了这一点遇到闪一下英文就不会慌。4.4 多个脚本互相冲突或与GitHub增强类扩展冲突装汉化脚本的用户大多还装了其他GitHub增强工具比如显示仓库目录树的、给代码行号加高亮的、一键打开GitHub1s的等等。多数情况下这些工具与汉化脚本能共存但确实存在冲突可能。冲突的常见表现是页面出现翻译翻译式的重复文本或者某个区域干脆变成空白。原因通常是两个脚本同时监听和修改同一批DOM节点互相把对方写入的内容再替换了一遍。排查办法很朴素先在Tampermonkey面板里把其他非必要脚本禁掉只保留汉化脚本刷新页面看是否恢复正常。如果恢复了再逐个启用其他脚本定位到冲突源。如果你同时装了独立翻译扩展比如某些浏览器自带的网页翻译工具这类扩展我建议在GitHub域名下直接关闭。它的整页翻译逻辑很容易误翻代码块里的字符串而且会和汉化脚本产生双层替换体验很差。5. 中文化之后的使用调优术语取舍与脚本共存5.1 哪些术语值得翻译哪些保持英文界面全中文之后第二个问题来了技术术语到底翻不翻我见过有人的GitHub界面连ForkBranchPull request都翻译成了复刻分支拉取请求看上去是中文但真要和别人讨论代码时反而对不上号因为教程、文档、命令行工具里全是英文原词。我的取舍思路是通用界面词全部翻译核心操作术语保留原文。具体来说像Repository翻译成仓库没问题因为这是逻辑概念不涉及具体操作Issues翻译成问题/议题也还行但ForkBranchMergePull request这四个词我建议保持英文或者至少在心里建立中英映射别把英文原文彻底丢掉。原因很实际你在GitHub上做操作时按钮、快捷键、帮助文档、报错信息全都会再次出现英文原词如果界面翻译把按钮文字改了文档反射弧就断了。好的汉化脚本基本都允许你在配置里关掉某些词条的翻译或者整体切换到中英对照模式。我个人的配置习惯是菜单、导航、设置项全用中文Issue标签、Pull request相关按钮保留英文原词代码相关选项全部保留原文。5.2 用自定义词条纠偏覆盖脚本没翻译好的地方再好的汉化脚本也不可能完全贴合每个人的用词习惯。很多时候你会觉得某个词翻译得生硬、不符合中文技术社区的表达习惯。这时候别凑合用去脚本提供的自定义词条功能里改。不同脚本的配置格式略有差异但核心逻辑都是建立一个英文原文对应中文译文的键值对。我自己用的是行式配置每一行一组映射格式非常简单可以在脚本的配置面板里直接改Repository仓库 Pull request拉取请求 Settings设置 raw原始文件 blame追溯 watch关注改完保存后刷新GitHub页面新的翻译就会覆盖默认翻译。这里有一个细节自定义词条的优先级必须高于默认词典否则你写了也白写。大部分脚本会标明这种优先级关系如果没有你可以先测试一个词条确认一下。如果你会一点JavaScript还可以直接改脚本源码里的字典。这种做法适合想深度定制的人但不建议普通用户这么做因为脚本一更新你改的东西就会被覆盖。更好的方式是把它做成独立的补充词条脚本通过grant unsafeWindow写到全局对全局接口不过这就需要一定的脚本编写能力了。5.3 与代码浏览增强工具共存先后加载顺序和体验取舍GitHub中文化会和其他日常开发工具同时使用我这里重点讲讲和增强类扩展的配合。我自己常用一个代码树插件来快速浏览仓库文件功能类似Octotree也有其他类似工具。这些增强工具通常会在GitHub页面左侧插入一个自己的侧栏面板面板内部的文本是由工具自己的脚本渲染的不会走汉化脚本的字典。所以经常出现很有趣的现象主题界面全部中文左侧代码树却是英文目录。这不算bug是因为增强工具渲染的内容不在汉化脚本的管辖范围之内。解决办法有两个第一看看增强工具自己有没有多语言设置有的话在它自己的配置面板里切换第二接受混合语言状态反正代码树上的核心信息是文件名和目录结构英文影响不大。另外建议增强工具脚本在run-at document-idle时执行并且晚于汉化脚本加载。Tampermonkey面板里可以拖拽调整脚本的启用顺序如果遇到侧边栏加载异常试着把汉化脚本排在前面。5.4 当GitHub更新界面导致脚本部分失效时怎么办GitHub前端几乎每个月都在改版有时候改个类名有时候调整DOM结构。汉化脚本如果还按旧选择器找文本节点就会漏翻或者完全不生效。遇到这种情况回到GreasyFork脚本页看更新动态。如果作者发布了新版本Tampermonkey会在面板里显示有可用更新点一下升级就行。如果作者很久没更新脚本页的反馈区大概率已经有人报错。此时你可以去脚本关联的开源仓库提一个Issue把失效的页面截图、浏览器版本、脚本版本都贴上方便作者定位。这比自己在脚本源码里硬编码一段替换语句要可靠得多。这里也提醒一句不要因为某个脚本失效了就临时装一个强制全文替换的通用脚本作为替代。那种脚本通常会对整个网页做无差别文本替换很容易把代码里的字符串也替换掉造成比英文更严重的阅读误导。宁可等几天等作者维护版本也别冒险。我个人用中文化脚本这一年多最大的体会是它适合做你认识GitHub的辅助工具不适合做你唯一依赖的翻译器。界面换成中文可以减少阅读阻力但写代码、查文档、和社区交流时英文原文还是会反复出现。我的建议是趁着界面已经中文化把Repository、Issue、Pull request、Fork、Branch这些词的英文原形当成记忆锚点看到一次中文就顺带记一次英文等用上一两个月你会发现英文界面也不是什么障碍了。到那时候就算脚本某天失效你也不会抓瞎。最后再分享一个小技巧如果你在公司电脑和个人电脑上都用GitHub建议两边同步同一套Tampermonkey脚本和自定义词条。脚本本身通过云端同步或者手动导出导入词条配置就复制一份JSON文件。这样不管在哪台机器上打开GitHub界面习惯都是一致的不用重复调教。GitHub中文化这件事装起来五分钟真正值钱的是后面根据自己的使用习惯把翻译打磨到顺手这一步值得你多花点时间。