vscode主题插件不显示在颜色主题列表中，八成是package.json中contributes.themes配置错误：必须为数组格式，且每个主题对象须完整包含label、uitheme（仅限"vs-dark"/"vs"/"hc-black"）、path（相对路径，含.json后缀）三个字段，缺一即失效。
主题插件不显示在「颜色主题」列表里？八成是 package.json 里的 contributes.themes 配错了——VSCode 不报错，只沉默忽略。
contributes.themes 必须是数组且字段不能少
哪怕你只发布一个主题，contributes.themes 也必须写成数组格式，不是对象。漏掉 label、uiTheme 或 path 中任意一个，主题就彻底失效。
-
label是用户在「Preferences: Color Theme」下看到的名称，纯字符串，别带空格或特殊符号（虽然能存，但某些旧版 VSCode 会截断） -
uiTheme只接受三个固定值："vs-dark"、"vs"、"hc-black"；填"dark"或"my-dark"都不会出现在对应模式的主题列表中 -
path是相对于package.json的路径，比如文件在themes/my-theme.json，就得写"path": "themes/my-theme.json"，漏掉.json后缀或写成绝对路径都会加载失败
theme JSON 文件里只有两个字段真正起作用
VSCode 主题文件（如 themes/my-theme.json）里，只有 colors 和 tokenColors 这两个顶层字段被识别。其他字段（比如 name、type、semanticHighlighting）只是元信息或兼容占位，删掉也不影响加载，但加了也没用。
-
colors控制 UI 元素：侧边栏、状态栏、标签页背景等，键名必须是 VSCode 官方 color ID（如editor.background、activityBar.foreground），不能自创 -
tokenColors是数组，每项含scope（TextMate 作用域）和settings（含foreground、background、fontStyle）；scope错配或settings.foreground没写，对应语法就保持默认色 - 别把
colors.editor.background和tokenColors里的background搞混：前者设整个编辑器背景，后者只影响单个 token 的局部背景（比如给keyword加底色）
本地调试时改了 theme 文件却没刷新？reload window 不够用
VSCode 不监听主题文件变化，也不会热重载。改完 themes/my-theme.json 后，按 Ctrl+Shift+P → 输入 Developer: Reload Window 才能生效。但如果你动的是 package.json 里的 contributes.themes 或路径，仅 reload 不行：
- 先在扩展面板里禁用你的主题插件（点齿轮图标 → Disable）
- 再启用（Enable）
- 最后再
Reload Window，否则新路径根本不会被读取
为什么 inspect 出来的 scope 在 theme 里不生效？
用 Developer: Inspect Editor Tokens and Scopes 查到的 scope（比如 support.function.console.js）必须完整、精确匹配才能命中。常见失效原因：
- scope 写成了
console或function，太宽泛，被更靠前的通用规则覆盖 - scope 写对了，但
tokenColors数组里这条规则位置太靠后，前面某条scope: "support.function"已经匹配并设置了颜色 - 当前文件语言没激活对应语法插件（比如打开
.py文件却配了 JavaScript 的support.function.builtin） - 用了带透明度的颜色但没写
#RRGGBBAA格式，#RGB或#RRGG会被忽略 alpha 通道
最稳妥的做法：先只配 comment、string、keyword 三个 scope，确认基础高亮出来，再逐步补全。别一上来就抄整套 tokenColors —— scope 语义随语言插件版本变，旧配置很容易集体失效。
