# [GitHub 中文化插件][github-project-link] > 让 GitHub 界面全面中文化 | 源自 [52cik/github-hans](https://github.com/52cik/github-hans) **简体中文** · [繁體中文](https://github.com/maboloshi/github-chinese/blob/HEAD/./README_zh-TW.md) · [反馈问题][github-issues-link] [![GitHub stars][github-stars-shield]][github-stars-link] [![GitHub forks][github-forks-shield]][github-forks-link] [![GitHub issues][github-issues-shield]][github-issues-link] [![license GPL-3.0][github-license-shield]][github-license-link] [![GreasyFork installs][greasyFork-shield]][greasyFork-link]

[!warning] 本项目从未发布至 GitCode，如您发现请截图并保留证据

🌟 功能特性

• [x] 全面中文化 GitHub 界面元素（菜单栏、标题、按钮等）
• [x] 智能正则匹配功能
• [x] 支持项目描述的人机翻译
• [x] 自动本地化时间元素
• [x] 持续更新词库

🌐 兼容环境

💻 安装指南

浏览器（Tampermonkey）

1. 安装用户脚本管理器：
   • 推荐：Tampermonkey
2. 基于 Chrome / Chromium 内核浏览器：
   1. 务必开启 “扩展程序” 管理中的 “开发者模式”¹
   2. 务必开启 “扩展程序” 管理中脚本管理器扩展的 “允许运行用户脚本”
   3. 具体可参考 Tampermonkey 官方指引
3. 选择安装源：
   • GitHub 源【开发版】
   • 南大镜像源【开发版】
   • GreasyFork 源【稳定版】
4. 刷新页面后，插件即可生效
5. 必要时，重启浏览器

[!NOTE] 版本说明： - 🚀 开发版：实时更新，每周五自动更新词库 - 🛡️ 稳定版：每周一同步开发版词库，更稳定

VS Code 集成浏览器

请参考扩展的自述文件。

🔧 本地调试

1. 安装 Tampermonkey，并启用 “允许访问文件网址”。
2. 下载词库文件到本地（如：D:\github-chinese\locals.js）
3. 在脚本管理器中修改引用路径： ```js // 原始路径 // @require https://raw.githubusercontent.com/...

// 修改为 // @require file:///D:/github-chinese/locals.js ``` 1. 刷新页面生效

[!IMPORTANT] 若无效： 1. 进入 Tampermonkey 插件设置页 1. 将 通用 - 配置模式 设置为高级，进入高级设置模式 1. 找到 安全 - 允许脚本访问本地文件 并设置为 外部(@require 和 @resource)

[!TIP] 💡 温馨提示： 您可以将词库文件拖拽至浏览器地址栏，复制路径直接使用。

🔄 更新日志

最新版本

v1.9.4.4 (2026-06-20)

1. 兼容修复1.9.2.4,1.9.4.4： - 区分 React GlobalNav 与页面主体共享的 Primer 弹层，恢复下拉菜单即时、完整翻译。

v1.9.4.3 (2026-06-17)

1. 兼容修复1.9.2.3,1.9.4.3： - 收窄 React 搜索模块忽略范围，恢复仓库议题页和搜索页主体区域翻译。

v1.9.4.2 (2026-06-17)

1. 兼容修复1.9.2.2,1.9.4.2： - 在保持 React 头部搜索框稳定的前提下，恢复头部导航、菜单、搜索弹层和提示翻译。

v1.9.4.1 (2026-06-16)

1. 临时修复1.9.2,1.9.4： - 关于 GitHub 引入 React 机制导致头部搜索框消失。副作用整个头部导航全部加入忽略规则，无法翻译。

v1.9.4 (2026-05-17)

1. 代码重构： - 全面结构化重组：抽离配置常量 CONFIG、状态管理器 State - 引入 safe() 错误边界包裹关键函数，便于排错 - 函数拆分细化：watchUpdate → setupMutationObserver + processMutations，transDesc → handleTransClick + requestRemoteTrans + showTransResult - processMutations 祖先去重：同一批 mutation 中后代节点不再重复遍历
2. 新增功能： - 翻译结果 UI 暗色主题适配（CSS 变量 + prefers-color-scheme 媒体查询），使用 GM_addStyle 插入 - 未命中词条管理器 MissedTermsManager（记录、导出 JSON、清空、统计、菜单） - 开发者模式（CONFIG.DEV）控制未命中词条菜单显隐 - Tampermonkey onurlchange 事件支持（setupUrlChangeListener）
3. 修复： - 修复翻译 API 响应 XSS 漏洞：innerHTML 模板拼接改为 textContent 安全赋值（由 #692 报告） - 修复 TreeWalker 过滤器在 ignoreSelectors 为空时抛出 SyntaxError - 修复翻译按钮可能重复添加的问题（nextSibling 空值检查） - 修复 RELATIVE-TIME shadowRoot 为 null 时的崩溃 - 修复从未识别页面离开后 State.pageConfig 未清空，导致旧配置残留的问题
4. 性能优化：减少无效迭代，消除不必要的 DOM 遍历

v1.9.3 (2024-08-18)

1. 新增功能：通过设置中文环境，自动本地化时间元素，仅保留on开头的时间正则，并停用时间元素监视
2. 优化突变翻译处理： - 引入characterDataPage规则，对特定页面启用筛选字符数据的变更 - 引入ignoreMutationSelectorPage规则，忽略特定突变元素
3. 合并reIgnoreClass，reIgnoreItemprop，ignoreId，ignoreTag为ignoreSelectorPage规则，处理全局及特定页面，忽略特定元素
4. 引入全局缓存模式，减少重复构建包括不限于基于page变化的忽略规则、正则规则数组等
5. 调整：更新讯飞听见翻译引擎v2.0
6. 优化：梳理、优化脚本
7. 调整：调整词库语言代码为zh-CN, 与环境语言设置一致

📌 待办事项

1. 添加 GitHub 专用名词解释
2. 整理 Git & GitHub 学习资料
3. 完善文档翻译，需大家 PR 共同翻译

🤝 参与贡献

欢迎通过以下方式参与贡献：

1. 完善词库翻译（编辑 locals.js）
2. 提交议题报告，参与话题讨论
3. 改进代码逻辑

翻译参考资源:

1. Pro Git 第二版 简体中文
2. Pro Git: 翻译约定
3. Git 官方软件包的简体中文翻译
4. GitHub 词汇表官方译本
5. CSS 选择器 用于编写忽略规则

查看详细贡献指南

🖼️ 效果预览

🙏 特别鸣谢

核心团队

• maboloshi - 项目作者
• wyc-26，陈生杂物房 - 项目协作者
• 52cik - 项目原作者

贡献者墙

一如既往，感谢我们出色的贡献者❤️！

贡献者列表，由 GitHub Action 自动生成

📈 项目统计

🎁 欢迎打赏

赞赏列表 | 微信赞赏 | 支付宝赞赏 | | :--------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------: | |
☕喝点咖啡继续干☕ |
🌶️来包辣条吧~🍪 |