vscode主题配置分三层：内置主题开关、ui微调、语法高亮细控；需严格遵循路径、命名、格式规范，否则设置静默失效。
VSCode 主题配置不是改一个文件就完事的，它分三层：内置主题开关、UI 区域微调、语法高亮细控。直接改 settings.json 里的 workbench.colorCustomizations 或 editor.tokenColorCustomizations 是最常用也最容易出错的路径——错一个字段名或嵌套层级，整块颜色就静默失效。
为什么改了 workbench.colorCustomizations 没反应？
这个对象只覆盖「已启用主题」定义好的 UI 色块，不是万能覆盖层。如果主题本身没声明 sideBar.background，你写进去也不会生效；反过来，如果主题硬编码了该值且没留 override 接口，你的设置也可能被忽略。
- 必须确认当前启用的主题支持自定义（多数主流主题如 One Dark Pro、Nord 都支持，但部分极简主题不开放）
-
workbench.colorCustomizations必须是顶层字段，不能嵌在"editor": {}或其他对象里 - 键名必须完全匹配 VSCode 官方色变量名，比如
"statusBar.background"不是"statusbar.bg"，大小写和中划线都不能错 - 值必须是合法十六进制（
"#1e1e1e"）、RGBa（"rgba(30, 30, 30, 0.9)"）或已知颜色名（"red"），不能用 CSS 变量或函数
editor.tokenColorCustomizations 怎么精准改某类语法？
别靠猜作用域名。VSCode 提供了实时探测工具：Ctrl+Shift+P → 输入 Developer: Inspect Editor Tokens and Scopes，然后点编辑器里任意代码，左下角立刻显示完整 token 链，比如 support.class.js 或 entity.name.function.ts。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 优先用具体 scope，避免写
"identifier"这种宽泛匹配，否则 JS/TS 的变量、参数、属性全被一锅端 - 字符串颜色建议改
"strings"字段（等价于{"scope": "string", "settings": {...}}），比手动写 scope 更稳 - 若要区分单双引号字符串，得用更细粒度的 scope：
"string.quoted.double.js"和"string.quoted.single.js" - 修改后保存
settings.json，无需重启，但需重新打开文件或切换标签页才能刷新高亮
自定义主题 JSON 文件放哪才被识别？
VSCode 不会扫描任意位置的 JSON 主题文件。扩展包内的主题必须严格放在 ./themes/ 目录下，且文件名全小写、用连字符、后缀为 .json 或 .ctm。漏建 themes/ 文件夹或放错路径，就会报 Extension 'xxx' has no themes。
- 路径必须是项目根目录下的
./themes/my-dark-theme.json，不能是src/themes/或dist/my-dark-theme.json - 文件名禁止空格、大写字母、中文，例如
MyTheme.json或dark theme.json都加载失败 - JSON 内必须有
"type": "dark"或"type": "light"，且"colors"和"tokenColors"为顶层字段 - 如果用了 TypeScript 编写主题，编译后的 JSON 才是最终产物，
.ts源文件不会被读取
真正难的不是写对字段，而是理解哪些颜色由主题控制、哪些由语言服务器接管、哪些又被用户设置覆盖。比如 editor.foreground 看似全局，实际只影响行号和空格符号；而 tokenColors 里一条模糊规则可能拖慢大型 TS 文件的渲染。动手前先用 Inspect 工具点几行代码，比查文档快得多。
