github-chinese

GitHub 中文化 (VS Code 扩展)

一键安装 GitHub 扩展，实现 VS Code 集成浏览器中 GitHub 网页的中文化。

工作原理

扩展启用 VS Code 的 proposed browser API（vscode.window.browserTabs + startCDPSession()）
在扩展宿主侧从南大镜像拉取词库 locals.js 与主脚本 main.user.js，规避页面 CORS 限制
通过 CDP Page.addScriptToEvaluateOnNewDocument 直接注入源码（非 eval），绕过 github.com 的 CSP 限制（IBE 因使用 new Function 被 CSP 拦截）
注入内容内置 GM_* 兼容层与 document-end 语义（等 DOMContentLoaded 后执行）

先决条件

添加启动参数

VS Code 必须带 --enable-proposed-api maboloshi.github-chinese 参数启动，否则无法使用 browser API。

带参数启动 VS Code 的方式

- 打开[运行对话框](https://learn.microsoft.com/windows/advanced-settings/modern-run)，输入： ```cmd "%LOCALAPPDATA%\Programs\Microsoft VS Code\Code.exe" --enable-proposed-api maboloshi.github-chinese ``` - 或修改[“开始”菜单](https://www.microsoft.com/zh-cn/windows/tips/start-menu)的 VS Code 快捷方式，在 `目标` 字段末尾追加 [COMMAND_LINE_ARGUMENTS](https://learn.microsoft.com/openspecs/windows_protocols/ms-shllink/17b69472-0f34-4bcf-b290-eccdb8de224b)： ```cmd --enable-proposed-api maboloshi.github-chinese ``` 然后从“开始”菜单启动

安装方式

方案一：从 GitHub Actions 下载（推荐）

该方案需要登录 GitHub 账号，若你没有账号，请使用方案二

打开本仓库的 Actions 页面
选择最近一次成功运行的 workflow
滚动到页面底部，在 Artifacts 区域下载 github-chinese-extension.vsix
在 VS Code 中按 Ctrl+Shift+P 打开命令面板
输入 Extensions: Install from VSIX... 并选择刚才下载的 .vsix 文件
安装完成后，在 VS Code 集成浏览器中刷新 GitHub 页面即可生效

方案二：从源码构建

环境要求

Git （可选，用于克隆仓库，若不打算安装 Git ，请自行将仓库下载至本地）
NodeJS

构建步骤

在 PowerShell 中执行以下代码：

git clone https://github.com/maboloshi/github-chinese.git # 克隆仓库

# 若你的网络环境无法访问 GitHub 克隆仓库，请自行寻找加速器等解决

cd github-chinese/vscode-extension # 进入插件目录

npm install # 安装依赖

# 若你的网络环境缓慢，请使用这行命令：

# npm install --registry=https://registry.npmmirror.com

npx @vscode/vsce package # 打包插件

构建完成后，按方案一的第 4-5 步安装生成的 .vsix 文件。

[!NOTE] 本扩展尚未上架 VS Code 市场，需通过源码构建或从 Actions 下载 VSIX 安装。

命令

GitHub 中文化: 检查注入状态 — 查看 browser API 可用性、注入标签数与词库加载状态
GitHub 中文化: 刷新集成浏览器注入 — 重新拉取词库/主脚本并重新注入所有已打开的集成浏览器标签

常见问题

为什么打开 GitHub 页面没有汉化？

请检查以下几点：

确认已安装依赖扩展：Integrated Browser Extensions 必须已安装并启用
确认启动参数正确：VS Code 必须带 --enable-proposed-api boylett.integrated-browser-extensions 参数启动
确认扩展已启用：在扩展面板中确认 GitHub 中文化 扩展已启用
刷新页面：在 VS Code 的集成浏览器中按 Ctrl+R 或 F5 刷新页面
重启 VS Code：尝试完全退出并重新启动 VS Code

调试

打开扩展开发宿主窗口。

This site is open source. Improve this page.