GitHub中文化插件安装与使用完整指南
2026/8/27 1:22:18 网站建设 项目流程

GitHub中文化插件安装与使用完整指南

【免费下载链接】github-chineseGitHub 汉化插件,GitHub 中文化界面。 (GitHub Translation To Chinese)项目地址: https://gitcode.com/gh_mirrors/gi/github-chinese

刷新页面后,导航栏变成中文

打开 github.com 的仪表盘,顶部 "Dashboard" 变成了"仪表盘",仓库页标签栏变成了"代码 / 议题 / 拉取请求",提交时间显示为"3 天之前"。这就是安装 GitHub 中文化插件后的效果,本文说明它的安装路径、效果边界,以及如何自定义词条。

一句话定位:它解决什么问题

它是一个面向 Tampermonkey 等脚本管理器的用户脚本,用本地词库文件 locals.js 把 GitHub 界面的菜单、按钮、时间等元素替换为中文,并覆盖 gist.github.com、githubstatus.com 等子站。适合想降低 GitHub 阅读门槛的开发者,以及希望按团队习惯定制术语的用户。

最短安装路径:3 步跑起来

  1. 安装脚本管理器:Chrome/Edge 选 Tampermonkey,Firefox 选 Violentmonkey,在扩展设置中开启"允许运行用户脚本"(较新 Chrome 还需开启"开发者模式")。
  2. 克隆仓库:
git clone https://gitcode.com/gh_mirrors/gi/github-chinese
  1. 用浏览器打开克隆目录中的 main.user.js,脚本管理器会提示安装,确认后刷新任一 GitHub 页面。

装完后,GitHub 界面的导航、按钮与时间显示都会变成中文。

初见效果:两个典型界面

浅色模式下的仪表盘:顶部 "Dashboard" 变为"仪表盘",搜索框提示文字变成"请键入 ↵ 去搜索",左侧边栏"置顶仓库""近期活动"均为中文,提交信息流的时间显示为"3 天之前"。

仓库页变化更多:标签栏变为"代码 / 议题 / 拉取请求 / 讨论 / 操作",统计按钮显示"已加星 731""已克隆 72",文件列表右列出现"3 小时之前"这类相对时间,右侧"关于"栏的条目名也全是中文。

深色模式布局与浅色版一致:"仪表盘""主页""发送反馈""筛选器"均保留,中文文字在深色背景上对比清晰,无需额外调整主题设置。

幕后原理:词库与正则匹配

主脚本 main.user.js 在 document-start 阶段运行,通过 MutationObserver 监听 DOM 变化,边渲染边匹配替换。词库 locals.js 里包含三类数据:页面路径正则(判断哪些页面需要翻译)、忽略规则(排除代码块、React 搜索模块等不该动的位置)和大量词条对。时间本地化依据系统语言自动启用,仓库描述还能调用讯飞翻译接口做人机翻译。开发版词库每周五更新,稳定版每周一同步。

进阶自定义:本地调试词库

当对某些翻译不满意、或需要补充团队术语时,可用本地调试模式:

  1. 在脚本管理器中开启"允许访问文件网址"(Tampermonkey 需在高级设置里把"允许脚本访问本地文件"设为"外部")。
  2. 把 locals.js 下载到本地,并将 main.user.js 中的 @require 一行改为本地路径,例如 file:///D:/github-chinese/locals.js。
  3. 修改 locals.js 中的词条并保存,刷新页面即可看到新译文;文件路径可把 locals.js 拖到地址栏直接复制。

修改后仓库详情页的中文翻译保持完整,自行补充的术语会在对应界面位置生效。另一个轻量方法:把 main.user.js 里的 CONFIG.DEV 设为 true 开启开发者模式,可以导出未命中词条列表、检查翻译覆盖率,适合排查漏译而不改动词库。

常见问题速查

症状处理
安装后无效果检查"允许运行用户脚本"是否开启,Ctrl+Shift+R 强制刷新,仍无效则重启浏览器
部分页面仍是英文多为 GitHub 界面更新导致词库滞后,更新仓库后重新刷新
下拉菜单、弹层漏翻更新到最新 main.user.js,近几个版本已多次修复 React GlobalNav 与搜索模块的兼容
脚本管理器识别不到脚本较新 Chrome(Manifest V3)需确认已开"开发者模式",并参考 Tampermonkey 官方 FAQ

项目生态:文件与贡献入口

  • main.user.js — 主脚本:DOM 监听、功能开关、翻译引擎调用
  • locals.js — 简体词库,含页面匹配、忽略规则与词条对
  • locals_zh-TW.js — 繁体词库
  • main(greasyfork).user.js / main(nju.edu).user.js — GreasyFork 稳定版与南大镜像安装源
  • vscode-extension/ — VS Code 集成浏览器扩展,经 CDP 注入同一套脚本与词库
  • script/ — CI 脚本与简繁转换工具 t2s-convert.pl

学习方面可参考 Tampermonkey 官方 FAQ(Chrome Manifest V3 下的脚本启用)和 CSS 选择器教程(用于编写忽略规则)。贡献入口是编辑 locals.js 补充词条、通过 Issues 提交翻译建议;提交繁体翻译时可用 script/t2s-convert.pl 做转换。

写在最后

再次打开仪表盘时,你看到的是"仪表盘""置顶仓库"和"3 天之前"。遇到不合习惯的术语,打开 locals.js 改一条即可,不必等下一次词库更新。

【免费下载链接】github-chineseGitHub 汉化插件,GitHub 中文化界面。 (GitHub Translation To Chinese)项目地址: https://gitcode.com/gh_mirrors/gi/github-chinese

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

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询