material theme 不生效的90%原因是未断开与内置主题/其他图标插件的绑定；需手动配置 workbench.colortheme 和 workbench.icontheme，并重启 vscode。
Material Theme 装不上、切不进去、图标乱码，90% 是因为没断开和内置主题/其他图标插件的绑定关系。 它不是装完就生效的“即插即用”主题，而是一套需要显式接管 workbench.colorTheme 和 workbench.iconTheme 的双组件系统。
VSCode 启动后 Material Theme 不显示？检查 workbench.colorTheme 是否被覆盖
VSCode 默认会加载内置主题（如 Default Dark+），只要 settings.json 里还留着这行，Material Theme 就永远不生效：
"workbench.colorTheme": "Default Dark+"
必须手动改成 Material 系列之一，例如：
"workbench.colorTheme": "Material Theme Palenight"
注意：名字必须完全匹配——大小写、空格、连字符都不能错。在命令面板中执行 Preferences: Color Theme，从下拉列表里选，比手敲更安全。
常见错误现象：
- 安装后重启 VSCode，界面毫无变化
- 命令面板里能搜到
Material Theme *，但点选后无反应 - 设置里显示“已启用”，但颜色仍是默认灰黑
文件树全是方块或默认图标？material-icon-theme 没启用或被冲突插件压制
Material Theme 扩展只管颜色，图标是另一个独立扩展：material-icon-theme。它不随主主题自动安装，必须单独搜、单独装、单独启用。
操作步骤：
- 在扩展市场搜索
material-icon-theme，认准作者是Philipp Kief - 安装后，在
settings.json中确认存在这一行："workbench.iconTheme": "material-icon-theme"
- 如果仍显示方块，大概率是之前装过
vscode-icons或vscode-great-icons—— 这些插件会抢占图标控制权，直接禁用它们
重启 VSCode 是必要动作；仅重载窗口有时无法刷新图标注册表。
选 Palenight 却发现 JSON key 颜色太淡？避开非主干变体 + 关注 tokenColors 兼容性
Palenight 是官方维护的稳定变体，但带 -Ocean、-Vivid、-Deepforest 后缀的版本大多来自社区分支，更新滞后。VSCode 1.85+ 已出现兼容问题，典型报错：
Cannot read property 'tokenColors' of undefined
这类错误本质是主题生成器输出的语法高亮定义格式不被新版解析器识别。解决方案很直接：
- 只选用官方维护的变体：
Material Theme、Material Theme Palenight、Material Theme Darker、Material Theme Lighter、Material Theme High Contrast - 避免任何含连字符+形容词的组合名（比如
Material Theme Ocean） - 如需微调 JSON key 颜色，不要改主题源码，用
editor.tokenColorCustomizations覆盖：
"editor.tokenColorCustomizations": {
"strings": "#ce9178",
"keys": "#9cdcfe"
}
强调色怎么换？别碰 material-theme.config.json，用 settings.json 直接配
旧教程常提修改 material-theme.config.json，但该文件在最新版中已弃用。所有强调色现在统一通过 materialTheme.accent 控制，值为预设字符串（不是十六进制）：
"materialTheme.accent": "Pink"
可选值包括：Pink、Blue、Purple、Cyan、Teal、Lime、Orange、Red、Graphite 等共 14 种，全部区分大小写。
重点提醒：这个配置项只影响侧边栏活动项、标签页高亮、按钮焦点等 UI 元素，不影响代码语法高亮——后者由 editor.tokenColorCustomizations 独立控制。
真正容易被忽略的是：强调色变更后，VSCode 不会热更新 UI，必须重启编辑器才能看到完整效果。临时切换试试看可以，但最终确认一定得关掉再打开。
