命令面板中preferences: file icon theme列表为空或选后无效，主因是图标主题扩展未被vscode识别：未重启（尤其macos需完全退出）、误装颜色主题（如one dark pro）、或settings.json中workbench.icontheme值与扩展id不匹配（如应写"material-icon-theme"而非"material icon theme"）。
Preferences: File Icon Theme 命令不生效怎么办
命令面板里输入 Preferences: File Icon Theme 后列表为空，或选了主题图标仍没变——这不是插件没装，而是 VSCode 根本没识别到图标主题扩展。常见原因有三个：
• 插件安装后没重启 VSCode（尤其是 macOS 上某些版本需完全退出再启动）
• 安装的是“主题类”扩展但非图标主题，比如搜 one dark 装了 One Dark Pro（这是颜色主题），它不会出现在图标主题列表里
• 扩展 ID 名字和设置项对不上，例如 material-icon-theme 的 ID 就是 material-icon-theme，不是 Material Icon Theme 或 material-icons
settings.json 里 workbench.iconTheme 配置无效的排查点
手动在 settings.json 加了 "workbench.iconTheme": "material-icon-theme" 却没反应，优先检查这三处：
• 当前打开的是文件夹（即工作区），.vscode/settings.json 里也得写一遍，否则用户级设置会被覆盖
• 右下角状态栏是否显示 Workspace Settings？显示就说明工作区设置已生效，用户级配置自动失效
• 开发者工具（Ctrl+Shift+P → Developer: Toggle Developer Tools）Console 里搜 icon，出现 Failed to load icon theme 就是 ID 写错或插件未启用
Material Icon Theme 的 files.associations 怎么写才生效
想让 .env.local 显示锁图标、pnpm-lock.yaml 和 package-lock.json 共用一个图标，必须用 material-icon-theme.files.associations 字段，且格式极敏感：
• 键必须是完整文件名（带点）或通配符扩展名：".env.local" ✅，env.local ❌； ✅，<code>"lock" ❌
• 值必须是该主题内置的图标 ID，不是文件类型名，也不是 SVG 文件名："lock" ✅，"lock.svg" ❌
• 图标 ID 列表不能靠猜，得去插件 GitHub 仓库的 icons/iconDefinitions.json 查，或在 VSCode 扩展页点「Contributions」标签看 iconDefinitions 列表
图标显示为方块 □ 或问号 ? 的真实原因
这不是主题问题，是字体符号缺失。VSCode 图标主题（尤其 vscode-icons）依赖 Nerd Fonts 渲染图标字符，Windows/macOS/Linux 表现不同：
• Windows 用户：必须安装并设置 editor.fontFamily 为 Fira Code Retina NF 或 JetBrainsMono Nerd Font 等带 NF 后缀的字体
• macOS 用户：装好字体后需在终端运行 sudo atsutil databases -remove 清除字体缓存，再重启 VSCode
• Linux 用户：装字体后运行 fc-cache -fv 刷新，否则 fc-list | grep -i nerd 可能查不到新字体
