VSCode主题不显示在「颜色主题」列表中，主因是package.json中contributes.themes配置错误：必须为数组格式，path需含.json后缀且为相对路径，uiTheme仅限"vs-dark"/"vs"/"hc-black"三值。
vsce package 生成的 .vsix 安装后主题不显示在「颜色主题」列表里
这不是 VS Code 报错，而是主题注册静默失败——VSCode 根本不加载它。最常见原因是 package.json 中 contributes.themes 配置有误。
-
contributes.themes必须是数组，哪怕只写一个主题也要包在[]里 -
path值必须是相对于package.json的路径，且带.json后缀，例如"path": "themes/dark-yan.json"；写成"themes/dark-yan"或"./themes/dark-yan.json"都会失效 -
uiTheme只接受三个固定值："vs-dark"、"vs"、"hc-black"；填"dark"或"Dark+就不会出现在对应 UI 模式下 - 本地调试时改了主题文件但没生效？按
Ctrl+Shift+P→ 输入Developer: Reload Window，不是重启 VS Code，也不是重装插件
主题 JSON 文件里改了 tokenColors 却没颜色变化
VSCode 只认 tokenColors 和 colors 这两个顶层字段，其他字段（比如 semanticHighlighting、settings）全被忽略。而且 tokenColors 里的每条规则，匹配顺序是从上到下，靠前的 rule 优先级更高。
- 别直接复制别人完整的
tokenColors数组——尤其注意每个scope对应的settings.foreground或settings.fontStyle是否为空或写错 -
scope是类 CSS 选择器风格，如"comment"、"string.quoted.double.ts"；写成"comments"或"string"可能不命中 - 想快速验证是否生效？先只保留 3 条：
{"scope": "comment", "settings": {"foreground": "#6a9955"}}、{"scope": "string", "settings": {"foreground": "#ce9178"}}、{"scope": "keyword", "settings": {"foreground": "#569cd6"}} - 不要在
tokenColors里设background来改编辑器背景色——那是colors.editor.background的职责；这里设background只影响单个语法单元（比如给keyword加底色）
vsce publish 失败但提示信息极简，比如 “Unauthorized” 或 “Publisher not found”
主题插件发布失败，90% 不是代码问题，而是认证链断裂或配置错位。VS Code Marketplace 不接受 GitHub 账号或微软账号密码，只认 Azure DevOps 的 PAT（Personal Access Token）。
- 必须先运行
vsce login（不是vsce publish），它会跳转浏览器完成授权；手动粘贴 token 到命令行是无效的 -
vsce login成功后会提示You are now logged in as <publisher>，这个<publisher>必须和package.json中的publisher字段**逐字符一致**（大小写敏感） - PAT 创建时，“Scopes” 至少勾选
Marketplace (Manage)；如果主题仓库用私有 Git，还得加Code (Read) - 检查
package.json的engines.vscode字段，比如写成"^1.85.0"，用户 VS Code 版本低于 1.85 就根本不会出现在市场搜索结果中
打包前被 Marketplace 审核拒绝的硬性合规项
这些项 vsce package 不校验，但 Marketplace 审核时一票否决，且不给修改机会。
-
icon字段指向的图片必须是 128×128 像素 的 PNG，不能是 512×512，也不能是 JPG 或 SVG；路径相对于package.json，名字不能含空格或中文 -
README.md必须存在，且首行必须是# <displayname>（比如# Yan Dark Theme），不能是空文件、不能只有链接、不能首行为二级标题 - 必须有非空的
LICENSE或LICENSE.md；MIT 协议可直接执行echo "MIT" > LICENSE - 主题插件不需要
activationEvents，但如果你写了，别写成["*"]—— VSCode 2025 年底起对通配符做了懒加载降级，可能导致主题延迟加载甚至不触发
主题类插件最隐蔽的问题，是所有错误都静默发生：不报错、不提示、不进日志。你得靠人工核对 contributes.themes 结构、path 路径、uiTheme 值、icon 尺寸这四点，缺一不可。
