VS Code 手动安装主题需将主题文件夹放入对应系统 themes 目录，确保含合规 package.json 或 theme-colors.json；重启后可在设置中选择，注意文件夹名勿含空格或中文。
VS Code 怎么安装主题（不靠 Marketplace 点点点）
主题本质是 JSON + CSS 资源包，VS Code 通过 themes 目录加载。安装主题最快的方式不是每次打开 Extensions 页面搜，而是手动放文件到正确位置。
- Windows：
%USERPROFILE%\AppData\Roaming\Code\User\themes -
macOS：
$HOME/Library/Application Support/Code/User/themes - Linux：
$HOME/.config/Code/User/themes
把解压后的主题文件夹（含 theme-colors.json 或 package.json）直接丢进去，重启 VS Code 就能在「Preferences > Color Theme」里看到它了。注意：文件夹名不能含空格或中文，否则可能识别失败。
切换主题时为什么找不到刚装的 theme
常见原因是主题包结构不合规——VS Code 只认两种格式：package.json 声明了 "contributes.themes"，或根目录有 theme-colors.json（旧式）。如果只是扔了个 .json 配色文件进去，不会生效。
- 检查主题文件夹里是否有
package.json，且内容包含类似："contributes": { "themes": [{ "label": "My Dark", "uiTheme": "vs-dark", "path": "./themes/my-dark-color-theme.json" }] } - 没有
package.json？那就必须确保配色文件路径写在theme-colors.json里，且文件名严格为该名称 - 改完配置后不用重装，但必须完全退出 VS Code（macOS 尤其要注意菜单栏「Quit Code」，不是关窗口）再启动
用命令行快速切换主题（适合多项目/配色方案切换）
VS Code 支持通过 workbench.colorTheme 设置直接指定主题 ID，比鼠标点更快，也方便写脚本或绑定快捷键。
- 先用
Developer: Inspect Editor Tokens and Scopes查当前主题 ID（比如OneDark-Pro或github-dark） - 在
settings.json中写："workbench.colorTheme": "OneDark-Pro"
- 想临时切？按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Preferences: Color Theme，回车后上下键选择，Enter 确认
注意：工作区级设置（.vscode/settings.json）会覆盖用户级设置，团队协作时容易因主题 ID 不一致导致显示错乱。
自定义主题颜色时 workbench.colorCustomizations 和 editor.tokenColorCustomizations 的区别
很多人改了颜色没反应，是因为混淆了作用域。前者控制侧边栏、状态栏、标题栏等 UI 元素；后者只管编辑器内语法高亮（比如 string、keyword 这些 token）。
- 改背景色、活动标签页颜色？用
workbench.colorCustomizations - 改
function关键字变红色、注释变灰色？用editor.tokenColorCustomizations - 两者都支持
textMateRules，但规则语法不同：UI 颜色用 CSS 类名（如tab.activeBackground），token 颜色用 TextMate scope（如support.function）
scope 名称得靠 Developer: Inspect Editor Tokens and Scopes 实时取，硬背容易错。而且部分主题禁用了 token 自定义，此时要先确认当前主题是否声明了 "editor.tokenColorCustomizations" 支持。
