VSCode自定义主题必须同时包含colors和tokenColors两个顶层字段，缺一则主题被静默忽略；colors控制UI控件色（如侧边栏、标题栏），tokenColors控制语法高亮（如keyword、string），二者不可替代且边界明确。
主题 JSON 文件必须同时包含 colors 和 tokenColors
只配 colors 会导致语法高亮完全不变，只配 tokenColors 则 UI 元素（侧边栏、标题栏、活动栏）仍用旧主题色。VSCode 启动时会校验这两个字段是否都存在，缺一即静默忽略整个主题文件。
常见错误现象：Extension 'xxx' has no themes 报错，或主题列表里压根不显示你的主题名——大概率是 JSON 缺了任一顶层字段，或字段名拼错（比如写成 token_color 或 Colors）。
-
colors是对象，键必须是 VSCode 预定义 color ID，例如editor.background、activityBar.foreground；不能自创 key -
tokenColors是数组，每项必须含scope（TextMate 作用域字符串）和settings（含foreground/background/fontStyle） - 想查全量 color ID 列表？命令面板输入
Developer: Generate Color Theme From Current Settings可导出当前生效的完整colors对象
tokenColors 与 semanticTokenColors 到底怎么选
tokenColors 覆盖所有语言，靠 TextMate 语法规则匹配，比如 keyword、string.quoted.double；semanticTokenColors 是语义化着色，依赖语言服务器返回类型信息（如把 const foo = 42 中的 foo 识别为变量），只在 TS/JS/Python（需开启）等少数语言中有效。
二者不互斥，但同名 scope 冲突时，semanticTokenColors 优先级更高。不过它默认关闭，用户得手动设 "editor.semanticHighlighting": true 才能生效。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 写通用主题：先填满
tokenColors，确保基础语法有颜色 - 支持精准着色：补
semanticTokenColors，比如区分function和method，但别指望它在 Markdown 或 Shell 中起作用 - 调试 scope：光标停在代码上，按
Ctrl+Shift+P→Developer: Inspect Editor Tokens and Scopes，左下角直接显示完整 scope 链，别猜
主题路径、命名与 package.json 的硬性要求
VSCode 不会自动创建 themes/ 目录，也不接受嵌套路径或大小写混用的文件名。主题文件必须放在扩展根目录下的 ./themes/your-theme-name.json，且 package.json 中 contributes.themes 必须正确定义入口。
常见错误现象：主题选单空空如也，或报错 Extension has no themes——90% 是路径或注册没对。
- 路径必须是
./themes/xxx.json，不能是src/themes/、dist/xxx.ctm或带空格的My Theme.json - 文件名建议全小写 + 连字符，如
dark-sage.json；大写字母、中文、下划线都会导致加载失败 -
package.json中contributes.themes数组每项必须含label（菜单显示名）、uiTheme（只能是vs-dark或vs）、path（相对package.json的路径，如./themes/dark-sage.json）
workbench.colorCustomizations 和自定义主题的关系
workbench.colorCustomizations 是用户层覆盖，优先级高于任何已启用的主题，但它只影响 UI 控件色（如标签栏、状态栏），**不影响语法高亮**。想改函数名颜色？它完全不生效。
典型误用：在 settings.json 里狂加 tab.activeBackground，结果发现只有标签变色，括号/注释/关键字还是老样子——因为那是 tokenColors 管的。
- 按语言染色标签：必须用
"[python]": { "tab.activeBackground": "#4b5563" }这种带方括号语言 ID 的写法 - 全局覆盖 UI 色：可直接写
"tab.activeBackground": "#ff0000"，但会破坏主题原有设计，慎用 - 它不能替代主题开发：只是临时微调，无法导出、无法分享、不参与主题市场分发
colors、tokenColors、semanticTokenColors、workbench.colorCustomizations 四层颜色控制的边界与协作关系——它们各自管什么、谁覆盖谁、哪里能动哪里不能碰，漏掉任意一层，主题就“看起来怪怪的”。 
