VSCode内置图标主题Seti和Minimal无需插件即可通过命令面板实时预览；装第三方主题需重启、确保ID匹配、正确配置workbench.iconTheme字段，并注意文件扩展名匹配规则。
直接用命令面板预览，不装插件也能看内置效果
VSCode 自带的图标主题只有 Seti 和 Minimal 两种（None 算作关闭状态），它们不用额外安装就能在命令面板里实时预览。你不需要等插件下载、重启或手动改 JSON——输入命令、选中、立刻看到资源管理器里的图标变化。
操作步骤很简单：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
Preferences: File Icon Theme并回车 - 用方向键上下切换，每选一个就立即刷新左侧资源管理器
注意：如果你没装任何第三方图标扩展，列表里就只有这三个选项。别急着搜“为什么没有 Material”，那是下一步的事。
装了 material-icon-theme 却看不到预览？检查这三处
装完插件后，它不会自动出现在图标主题列表里——必须重启 VSCode 或至少重载窗口（Cmd+R / Ctrl+R）。但更常见的问题是：你装的是 vscode-icons，却在命令面板里搜 material，结果根本找不到；或者反过来，装了 material-icon-theme，却在设置里写了 "workbench.iconTheme": "vscode-icons"，配置和插件不匹配。
确认是否生效，看这三点：
- 扩展面板里该插件状态是 已启用（不是“已安装但禁用”）
- 命令面板执行
Preferences: File Icon Theme后，下拉列表中出现Material Icon Theme（注意大小写和空格，必须完全一致） - 资源管理器里任意一个
.json、.ts、Dockerfile文件图标已更新，不是默认文档图标
如果列表里名字对不上，大概率是插件 ID 写错了。比如 material-icon-theme 的 ID 就是它本身，不是 material-icons 或 material-theme。
settings.json 里配错字段名，图标主题就静默失效
很多人想“永久锁定图标主题”，就去改 settings.json，结果发现改完没反应。最常踩的坑是字段名拼错：workbench.iconTheme 写成 workbench.fileIconTheme、icon.theme 或 fileIconTheme ——这些全都不识别，VSCode 会直接忽略整行，也不报错。
正确写法只有一种：
"workbench.iconTheme": "material-icon-theme"
注意：
- 引号内值必须和插件市场页面右上角显示的 Extension ID 完全一致（可在插件详情页 → “Contributions” 标签页确认）
- 这个字段只控制图标，和
workbench.colorTheme（颜色主题）无关，两者互不影响 - 如果工作区有
.vscode/settings.json，它会覆盖用户级设置，得在里面也加一遍
预览时发现某些文件图标没变？不是主题问题，是匹配逻辑限制
图标主题不会“智能识别语言”，它靠的是文件扩展名或文件名硬匹配。比如 material-icon-theme 默认给 .js 上 JS 图标，但不会给 webpack.config.cjs 上 Node.js 图标——除非你在 material-icon-theme.files.associations 里手动加映射。
常见“没变”的情况：
-
.env.local还是普通齿轮图标 → 需加"env.local": "file_type_env" -
astro.config.mjs没有 Astro 图标 → 需加"astro.config.*": "astro" -
pnpm-lock.yaml显示 YAML 图标 → 因为它先匹配.yaml，后缀优先级高于文件名
所有 files.associations 规则都只支持两种格式：.ext（扩展名）和 filename（完整文件名），不支持通配符如 *.config.* 或正则。这点很容易想当然，但 VSCode 就是不认。
真正影响预览效果的，往往不是主题本身好不好看，而是扩展名是否被收录、配置字段有没有拼错、以及工作区设置有没有偷偷覆盖掉你的选择。改完记得重载窗口，别只保存 JSON 就以为完事了。
