VSCode插件市场中主题类插件的打包与发布注意事项-VSCode-PHP中文网

vscode主题不显示在「颜色主题」列表中，主因是package.json中contributes.themes配置错误：必须为数组格式，path需含.json后缀且为相对路径，uitheme仅限"vs-dark"/"vs"/"hc-black"三值。

vscode插件市场中主题类插件的打包与发布注意事项

这不是 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，也不是重装插件

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 加底色）

主题插件发布失败，90% 不是代码问题，而是认证链断裂或配置错位。VS Code Marketplace 不接受 GitHub 账号或微软账号密码，只认 Azure DevOps 的 PAT（Personal Access Token）。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

必须先运行 vsce login（不是 vsce publish），它会跳转浏览器完成授权；手动粘贴 token 到命令行是无效的
vsce login 成功后会提示 You are now logged in as <publisher></publisher>，这个 <publisher></publisher> 必须和 package.json 中的 publisher 字段**逐字符一致**（大小写敏感）
PAT 创建时，“Scopes” 至少勾选 Marketplace (Manage)；如果主题仓库用私有 Git，还得加 Code (Read)
检查 package.json 的 engines.vscode 字段，比如写成 "^1.85.0"，用户 VS Code 版本低于 1.85 就根本不会出现在市场搜索结果中

这些项 vsce package 不校验，但 Marketplace 审核时一票否决，且不给修改机会。

icon 字段指向的图片必须是 128×128 像素 的 PNG，不能是 512×512，也不能是 JPG 或 SVG；路径相对于 package.json，名字不能含空格或中文
README.md 必须存在，且首行必须是 # <displayname></displayname>（比如 # Yan Dark Theme），不能是空文件、不能只有链接、不能首行为二级标题
必须有非空的 LICENSE 或 LICENSE.md；MIT 协议可直接执行 echo "MIT" > LICENSE
主题插件不需要 activationEvents，但如果你写了，别写成 ["*"] —— VSCode 2025 年底起对通配符做了懒加载降级，可能导致主题延迟加载甚至不触发