vscode主题生效需同时满足两个json字段：package.json中contributes.themes数组必须严格配置path（相对路径+json后缀）和uitheme（仅vs-dark/vs/hc-black），且theme.json必须包含合法colors与tokencolors结构。
VSCode 主题不是写代码，是精准配置两个 JSON 字段：缺一个，主题就“消失”——不报错、不提示、不显示在颜色主题列表里。
package.json 里 contributes.themes 配置必须严格对齐路径和类型
VSCode 不扫描文件夹找主题，它只认 package.json 里声明的路径。哪怕只错一个字符，主题就进不了「颜色主题」列表。
-
path必须是相对于package.json的相对路径，带.json后缀，例如"path": "themes/my-theme.json"；写成"./themes/my-theme"或"src/themes/my-theme.json"都无效 -
uiTheme只接受三个固定值："vs-dark"、"vs"、"hc-black"；写成"dark"、"light"或"VS-DARK"全部静默失败 -
contributes.themes必须是数组，哪怕只注册一个主题，也得写成[{}]；写成对象{}或空值会被直接忽略 - 如果要支持深色+浅色双主题，必须在
contributes.themes数组里声明两项，各自指向不同 JSON 文件，不能在一个文件里混写
theme JSON 必须同时含 colors 和 tokenColors，且结构合法
只改 colors（比如 editor.background），代码区还是默认高亮；只写 tokenColors，侧边栏、状态栏仍是原样。两者缺一不可，VSCode 启动时会校验这两个顶层字段是否存在。
-
colors是对象，键名必须是官方 color ID，例如activityBar.background、tab.activeBorder；大小写错误或自造 key（如sidebarBg）完全无效 -
tokenColors是数组，每项必须含scope（字符串或字符串数组）和settings（至少含foreground）；settings.fontStyle只接受"italic"、"bold"、"underline"或空字符串，不能写"bold italic"（要用空格分隔） - 颜色值必须是标准十六进制格式，如
"#28a745"；写成"28a745"或"rgb(40,167,69)"会被跳过
scope 名称不能猜，必须用 Developer: Inspect Editor Tokens and Scopes 实时抓取
复制别人主题里的 "entity.name.function" 却没效果？大概率是因为当前文件没装对应语言插件，或者 scope 链更长（比如 "entity.name.function.ts"）。靠文档或记忆匹配几乎必失败。
- 打开任意源码文件（如
index.ts），把光标停在想改色的词上（比如一个函数名） - 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入并执行Developer: Inspect Editor Tokens and Scopes - 面板显示的 scope 链中，优先用最靠右、最具体的那一段（如
entity.name.function.ts） - 同一元素可能被多个规则匹配，
tokenColors数组顺序即匹配优先级——把你写的规则放前面
调试预览和打包上传的关键动作
按 F5 启动扩展开发主机窗口可实时预览主题效果，但最终生效依赖完整打包流程。
- 先确保
package.json和主题 JSON 文件都在项目根目录下可访问，且无语法错误（可用 VSCode 自带 JSON 校验） - 运行
vsce package打包生成.vsix文件；若报错 “No extension to package”，说明package.json缺少必要字段（如publisher、engines.vscode）或contributes结构非法 - 安装
.vsix前，先在 VSCode 设置中关闭「启用扩展自动更新」，避免本地调试版被线上同名插件覆盖 - 发布到 Marketplace 前，必须用
vsce login <publisher-id></publisher-id>登录，token 来自 Azure DevOps 个人访问令牌（PAT），且权限需勾选Marketplace (Manage)
最容易被忽略的是：VSCode 对主题配置的校验是“全有或全无”的——路径错一级、uiTheme 拼错、tokenColors 少个 settings.foreground，都会导致整个主题不加载，且没有任何日志或提示。验证前，先删掉所有非必要字段，只留最简 colors + 三条 tokenColors 规则，能跑通再逐步加。
