vsce package 打包前必须创建 themes/ 目录并放入合法 json 主题文件，文件名全小写加连字符，json 需含 type 字段且 package.json 的 contributes.themes 必须正确定义路径。
vsce package 打包前必须有 themes/ 目录和合法 JSON
VSCode 主题插件打包不是把 settings.json 丢进去就行，它要求项目结构严格符合扩展规范。最常被跳过的一步是：手动在项目根目录下创建 themes/ 文件夹，并把主题文件（如 my-cool-theme.json）放进去——VS Code 不会自动生成这个路径，yo code 生成的模板也只建了骨架，themes/ 得你自己建。
常见错误现象：Extension 'xxx' has no themes 报错，或打包后安装，主题列表里压根不显示名字。
- 文件名必须全小写 + 连字符，不能有空格、大写字母、中文，比如
oceanic-next.json合法，Oceanic Next.json或oceanic_next.json都加载失败 - JSON 必须格式正确，且顶层包含
"type": "dark"或"type": "light"字段；漏掉type，VS Code 会直接忽略该文件 - 如果同时支持暗/亮模式，建议用同一文件内
"colors"+"tokenColors"分别定义，不要拆成两个文件
vsce package 命令本身不校验主题内容合法性
vsce package 只检查 package.json 结构、图标路径、themes/ 是否存在，但不会验证 themes/*.json 里的 tokenColors scope 是否拼错、colors 键名是否有效、甚至 JSON 是否能被解析。结果就是：包能打出来，安装后主题不生效，还查不出原因。
真正要提前发现这类问题，得靠 VS Code 自带的校验机制：
- 在扩展开发窗口按
F5启动 Extension Development Host，如果主题文件有语法错误或字段非法，控制台会直接报红并提示具体行号 - 打开命令面板，运行
Developer: Inspect Editor Tokens and Scopes，点选代码后看右下角是否正常显示 token 链——如果主题没加载，这里就看不到任何高亮匹配 - 临时把
themes/下的 JSON 拖进普通编辑器，用在线 JSON 校验工具（如 jsonlint.com）跑一遍，排除格式硬伤
打包后主题不出现？检查 package.json 的 contributes 字段
就算 themes/ 路径对、JSON 合法，package.json 里没声明主题贡献点，VS Code 依然当它不存在。关键字段是 "contributes": {"themes": [...]}，且数组每一项必须精确指向 JSON 文件路径（相对于项目根目录）。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
示例正确写法：
{
"contributes": {
"themes": [
{
"label": "My Cool Theme",
"uiTheme": "dark",
"path": "./themes/my-cool-theme.json"
}
]
}
}
容易踩的坑：
-
path值写成"themes/my-cool-theme.json"（缺./）或"./src/themes/my-cool-theme.json"（路径错位），都会导致加载失败 -
label里用了 emoji 或特殊符号，某些旧版 VS Code 会截断显示，建议纯 ASCII - 多个主题共存时，每个
theme对象的label必须唯一，重复会导致部分主题不可选
本地安装 .vsix 后仍不生效？主题可能被锁定
打包完 .vsix 文件，双击安装或用 Extensions: Install from VSIX 命令装上，但主题列表里还是没有——这时候大概率不是打包问题，而是当前启用的主题“锁死”了用户自定义。
某些流行主题（如 One Dark Pro、Nord）在自己的 package.json 里写了 "_defaults": true，这会让 VS Code 忽略所有 editor.tokenColorCustomizations 和 workbench.colorCustomizations 设置，包括你刚装的插件主题。
验证方法：
- 先切换到官方默认主题（
Default Dark+或Light+），再打开主题选择面板（Ctrl+K Ctrl+T），你的主题应该会出现 - 如果出现了，说明问题出在主题兼容性上，不是打包失败；可考虑在自己主题的
package.json中加"extensionKind": ["ui"]明确声明运行环境 - 别依赖
settings.json里的editor.tokenColorCustomizations来“补救”，那是覆盖逻辑，不是主题注册逻辑
package.json、VS Code 运行时三者之间的契约关系——少一个字段、错一个斜杠、多一个空格，整个主题就静默失效。调试时优先看 F5 控制台输出，而不是反复重打 vsix。
