必须安装 GitHub Theme 扩展才能启用 GitHub Light 或 GitHub Dark 主题;安装后需通过命令面板执行 Preferences: Color Theme 手动选择,且 settings.json 中 "workbench.colorTheme" 值须严格匹配全称,并配合 SFMono 字体与 13px 字号方可完整还原。

GitHub 官方的浅色(GitHub Light)和深色(GitHub Dark)主题必须通过 VS Code 扩展市场安装 GitHub Theme 扩展后才能启用,不是内置主题,也不能直接从“颜色主题”列表里点选就生效。
安装 GitHub Theme 扩展是前提
VS Code 自带的主题列表里没有 GitHub Light 或 GitHub Dark——它们由独立扩展提供。不装这个扩展,后续所有配置都无效。
- 点击左侧活动栏的扩展图标(四个方块),或按
Cmd+Shift+X(macOS)/Ctrl+Shift+X(Windows/Linux) - 搜索
GitHub Theme,认准发布者是 GitHub(带 Verified Publisher 徽章) - 点击“安装”,完成后建议手动点击“重新加载”按钮(非必须但可避免缓存残留)
- 如果安装后命令面板里搜不到
GitHub Light,大概率是扩展没装成功或被其他主题插件干扰
启用主题必须走 Preferences: Color Theme 命令
扩展装完不会自动激活主题,必须显式选择。设置界面里的下拉菜单有时会漏掉新主题,命令面板最可靠。
- 按
Cmd+Shift+P(macOS)或Ctrl+Shift+P(Windows/Linux)打开命令面板 - 输入
Preferences: Color Theme并回车 - 在弹出列表中找全称:
GitHub Light、GitHub Dark、GitHub Light Default或GitHub Dark Default(不同版本命名略有差异) - 选中后立即生效,无需重启;若无反应,检查状态栏右下角是否显示语言模式为
Plain Text(需打开一个 .ts/.py/.md 文件触发语法高亮加载)
settings.json 配置要写对名称,大小写敏感
手动配置时,"workbench.colorTheme" 的值必须与命令面板里显示的完整名称完全一致,包括空格和大小写,否则主题加载失败且无报错提示。
当用户提及 GitHub URL,或要求分析、审查、探索或理解任意 GitHub 项目、仓库或代码库时,请使用此技能。触发条件包括以下短语:“分析这个项目”、“看看这个仓库”、“analyze this repo”、“what does this project do”,或消息中包含任何 github.com URL。
- 打开
settings.json(命令面板输入Preferences: Open Settings (JSON)) - 添加或修改这一行:
"workbench.colorTheme": "GitHub Light"(注意引号、冒号、逗号) - 保存后 VS Code 会自动应用;如果界面没变,说明名称拼错了,回到上一步用命令面板确认准确字符串
- 不要写成
"github-light"、"GitHub light"或"GitHubLight"——这些都不识别
字体和字号不配齐,视觉还原就缺一块
只换主题颜色,不改字体,编辑区看起来还是不像 GitHub.com。官方主题依赖 SFMono-Regular 字体栈和 13px 字号才能对齐网站渲染效果。
- 在设置中搜索
editor.fontFamily,设为:"'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace" - 搜索
editor.fontSize,设为13 - macOS 用户若系统未预装 SFMono,可去 Apple 开发者网站下载或改用
'SF Mono'(注意空格) - 改完不生效?检查有没有其他扩展(如自定义 CSS 插件)覆盖了字体设置
最容易被忽略的是:主题扩展装了 ≠ 主题启用了 ≠ 字体配对了。三者缺一不可,而且 GitHub Light 和 GitHub Dark 是两个独立选项,不会随系统明暗模式自动切换——你得自己决定用哪个,并确保 settings.json 里写的名称跟命令面板里看到的一模一样。










