vscode不识别本地theme.json是因为主题必须打包为扩展并声明contributes.themes；直接放入目录无效，需创建themes/文件夹、确保json含"type":"uitheme"、用vsce打包安装。
VSCode 无法直接“关联”本地 JSON 颜色配置文件——你放进去的 theme.json 不会自动出现在颜色主题列表里，除非它被正确打包为扩展并启用。
为什么直接把 theme.json 放进 .vscode/ 或 extensions/ 目录没用
VSCode 的主题系统只加载已安装的扩展中声明为 uitheme 类型、且路径符合约定的 JSON 文件。它不扫描用户目录下的任意 JSON，也不读取 .vscode/ 下的配置作为主题源。
- 把
dark-sage.json直接丢进~/.vscode/extensions/→ VSCode 完全无视，控制台可能报Extension 'xxx' has no themes - 放在项目根目录的
.vscode/settings.json里写workbench.colorCustomizations→ 这是 UI 覆盖，不是主题，不会出现在 Ctrl+K Ctrl+T 列表中 - 主题文件名含空格、大写或中文（如
My Theme.json）→ 加载失败，不报错但不可见
正确路径：必须手动建 themes/ 目录并打包为扩展
本地开发主题的本质是写一个 VS Code 扩展，哪怕只含一个主题文件。
VSCode 1.118
下载
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 在扩展项目根目录下手动创建
themes/文件夹（VSCode 不会自动生成） - 把主题文件命名为全小写 + 连字符，如
dark-sage.json，放入themes/ - 确保 JSON 格式合法，并包含
"type": "uitheme"字段和"uiTheme"值（如"vs-dark"） - 用
vsce package打包成.vsix，再通过Extensions: Install from VSIX安装
常见错误：改了 workbench.colorCustomizations 却找不到主题名
这是混淆了两种机制：workbench.colorCustomizations 是运行时覆盖，不是主题定义。它不会让新主题出现在颜色主题选择面板中。
- 你在
settings.json里加了"[MyTheme]": { "editor.background": "#1e1e1e" }→ 这只是告诉 VSCode：“当激活名为MyTheme的主题时，才应用这条规则”，但它不会凭空造出MyTheme - 若
MyTheme从未被安装或未在扩展中正确定义，Ctrl+K Ctrl+T 列表里就永远看不到它 - 真正要“注册”一个主题名，必须通过扩展 manifest（
package.json）里的contributes.themes字段声明
调试主题加载失败的三个关键检查点
主题装了却不见？优先查这三项，90% 的问题出在这里。
- 扩展是否已启用：右键扩展 → “启用”，禁用状态的主题不会注册到主题系统
-
themes/路径是否在扩展根目录下，且文件名是xxx.json（不是xxx.ctm或嵌套在src/里） -
package.json中contributes.themes是否指向了正确的文件路径，例如"./themes/dark-sage.json"，路径必须相对扩展根目录
主题开发最易被忽略的点：它不是“改个配置就能热更新”的功能，而是一次构建 + 安装 + 启用的完整扩展流程。少一步，主题就只是硬盘上的一个 JSON 文件。
