VSCode安装自定义颜色主题必须通过“Extensions: Install from VSIX”命令安装.vsix文件或打包GitHub仓库后安装，不可双击拖入；启用需手动执行Preferences: Color Theme，且package.json中必须正确定义contributes.themes字段。
如何在 VSCode 中正确安装他人分享的自定义颜色主题（.vsix 或 GitHub 仓库）
直接双击 .vsix 文件或拖进 VSCode 窗口，大概率会失败——VSCode 默认禁止未签名的扩展安装。必须先开启开发者模式或通过命令行强制安装。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入并执行Extensions: Install from VSIX... - 选择下载好的
.vsix文件，重启 VSCode 后在设置（Ctrl+,）→Color Theme下即可启用 - 若主题来自 GitHub 仓库（如
username/theme-name），先用git clone拉取，再在 VSCode 中打开该文件夹，按Ctrl+Shift+P运行Extensions: Package Extension打包为 .vsix，再安装 - 注意：主题作者若未在
package.json中正确定义"contributes.themes"字段，即使安装成功，也不会出现在主题列表里
为什么你改了 workbench.colorCustomizations 却没生效
这个配置项只覆盖「已启用主题」的特定颜色变量，不是万能覆盖层；它不会修改语法高亮（token color），也不影响侧边栏图标、状态栏背景等由主题本身硬编码的部分。
- 确保你在
settings.json中写的是顶层字段，不是嵌套在其他对象里：{ "workbench.colorCustomizations": { "activityBar.background": "#2d3748", "statusBar.background": "#4a5568" } } - 如果主题用了
dark_plus作为 base，但你当前启用的是Default Dark+，那workbench.colorCustomizations会应用到后者——务必确认当前启用的主题名完全匹配 - 某些 UI 元素（比如终端光标、编辑器滚动条）受系统级 CSS 注入影响更大，这时得配合
vscode-custom-css插件（需手动启用开发者工具并重载）
tokenColorCustomizations 覆盖语法高亮时的三个关键限制
它只能修改「已存在」的 token 类型（如 string、keyword、comment），不能新增语法规则，也不能基于上下文条件区分（比如“只有在 React JSX 中的 string 才变蓝”）。
- 必须配合语言标识符使用，否则全局生效：
"editor.tokenColorCustomizations": { "textMateRules": [ { "scope": "string", "settings": { "foreground": "#9ae2b3" } } ] } - 作用域（
scope）名称依赖当前激活的语言扩展和 TextMate 语法包，不同语言的 scope 差异极大；推荐用Developer: Inspect Editor Tokens and Scopes命令实时查看光标处的实际 scope 链 - 若某语言（如 Rust 或 Solidity）使用 Tree-sitter 解析而非 TextMate，则
tokenColorCustomizations完全无效——这类语言需等其扩展自身提供 theme 支持或改用插件级着色方案
分享你自己的主题前，必须验证的三件事
很多人把 themes/xxx.json 直接扔到 GitHub 就算发布，结果别人装上后一片灰白——主题文件只是冰山一角。
- 检查
package.json中的contributes.themes是否包含正确的路径（如./themes/my-theme-color-theme.json），且该路径下文件真实存在 - 确认
themes/my-theme-color-theme.json里至少定义了base（vs-dark/hc-black/vs），否则 VSCode 不知道该继承哪套默认样式 - 用
npm install -g vsce安装打包工具，运行vsce package生成 .vsix，再本地安装测试一次——很多路径错误、JSON 格式问题、缺失字段，只在这个环节才暴露
