vscode主题必须同时配置colors和tokencolors两个json字段，缺一不可；colors控制界面色，tokencolors控制语法高亮，且package.json中contributes.themes路径、uitheme值及结构须严格符合规范。
VSCode 主题不是“写代码”，而是精确配置两个 JSON 字段：colors 控制界面色，tokenColors 控制语法高亮；漏掉任一字段、路径错一级、uiTheme 值拼错，主题都会静默消失——你搜不到它，VSCode 也不会报错。
theme 文件必须同时包含 colors 和 tokenColors
只填 colors（比如改了 editor.background），代码区域依然用默认高亮；只填 tokenColors，侧边栏、状态栏还是原样。两者缺一不可，VSCode 启动时会校验这两个顶层字段是否存在。
-
colors的键名必须是官方定义的 color ID，例如activityBar.background、tab.activeBorder，不能自创或大小写错误 -
tokenColors是数组，每项必须含scope（如"comment"）和settings（至少含foreground） - 想快速验证是否生效？先只写三条最基础的：
{"scope": "comment", "settings": {"foreground": "#6c757d"}}、{"scope": "string", "settings": {"foreground": "#28a745"}}、{"scope": "keyword", "settings": {"foreground": "#dc3545"}}
package.json 中 contributes.themes 必须严格匹配路径与类型
VSCode 不扫描文件夹找主题，它只认 package.json 里声明的路径。写错一个字符，主题就进不了「颜色主题」列表，且无任何提示。
-
path是相对于package.json的路径，比如主题文件在themes/my-theme.json，就得写"path": "themes/my-theme.json"，不能漏.json，也不能写成./themes/...或src/themes/... -
uiTheme只接受三个固定值："vs-dark"、"vs"、"hc-black"；写成"dark"、"light"或大小写混搭（如"VS-DARK"）均无效 -
contributes.themes必须是数组，哪怕只注册一个主题，也要写成[{...}]，写成对象或空值会直接忽略
别猜 scope 名称：用 Developer: Inspect Editor Tokens and Scopes 实时定位
复制别人主题里的 "entity.name.function" 却没效果？大概率是因为当前文件没装对应语言插件，或者 scope 链更长（比如 entity.name.function.ts）。靠文档或记忆匹配几乎必失败。
- 打开任意源码文件（如
index.ts），把光标停在想改色的词上（比如一个函数名） - 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux），输入并执行Developer: Inspect Editor Tokens and Scopes - 面板左下角显示完整 scope 链，例如
source.ts meta.function.ts entity.name.function.ts；优先用最靠右、最具体的那一段（如entity.name.function.ts） - 同一元素可能被多个规则匹配，
tokenColors数组顺序即匹配优先级——把你写的规则放前面
改完不生效？不是缓存问题，是没重载窗口
VSCode 不监听主题文件变化，保存 my-theme.json 后，编辑器完全无感知。你看到的还是旧主题，除非手动触发重载。
- 按
Cmd+Shift+P输入Developer: Reload Window回车，这是唯一有效的刷新方式 - 确认当前已启用你的主题：按
Cmd+K Cmd+T打开颜色主题面板，检查是否选中了label里定义的名字（不是文件名） - 如果仍不出现，打开开发者工具（
Help → Toggle Developer Tools），切到 Console 标签页——主题加载失败不会报错，但如果有Extension 'xxx' has no themes提示，说明contributes.themes结构或路径有硬伤
真正卡住人的地方，往往不是逻辑多复杂，而是 package.json 里一个斜杠方向错了，或是 tokenColors 少了个逗号导致 JSON 解析失败——VSCode 安静地跳过整个文件，连日志都不留。
