VS Code 图标扩展不生效是因为 workbench.iconTheme 未手动配置：需通过命令面板执行 Preferences: File Icon Theme 并选择主题以写入设置；注意工作区配置覆盖、远程环境锁定、Nerd Fonts 字体依赖及扩展 ID 的严格格式要求。
装完图标扩展不生效，不是插件坏了，而是 VS Code 压根没启用它——workbench.iconTheme 配置项必须手动写入，否则永远显示方块图标。
Preferences: File Icon Theme 必须手动触发一次
VS Code 不会自动激活新安装的图标扩展，哪怕你看到状态是“已启用”。这一步缺失，settings.json 里就不会生成 workbench.iconTheme 字段，图标自然不出现。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入并选择
Preferences: File Icon Theme - 从下拉列表中**点选一次**你刚装的主题（例如
material-icon-theme），即使它看起来已经高亮 - 这个操作会强制写入配置，且优先级高于手动编辑
settings.json
别让工作区设置悄悄覆盖全局配置
如果你在某个项目文件夹里打开了 VS Code，右下角显示 “Workspace Settings”，那说明当前窗口正在读取 .vscode/settings.json。这个文件里的 workbench.iconTheme 会无提示地覆盖用户级设置。
- 检查
.vscode/settings.json是否存在且含有"workbench.iconTheme": null或其他值 - 如果不需要项目级图标定制，直接删掉这一行；需要的话，确保值是正确的扩展 ID，比如
"material-icon-theme" - 远程开发（SSH / Dev Container / Codespaces）时，容器内可能自带锁定配置，得进去删
图标显示为方块？先查字体，不是插件问题
很多图标包（尤其是 vscode-icons）依赖 Nerd Fonts 渲染符号。Windows 用户最常卡在这步：系统没装、VS Code 没配、或者配错格式。
- 下载并安装 Nerd Fonts（推荐
FiraCode Nerd Font） - 在 VS Code 设置里搜索
editor.fontFamily，填入：'FiraCode Nerd Font', 'Consolas', monospace - 注意单引号、逗号、空格都必须严格匹配，少一个都会 fallback 到默认字体
- macOS 用户通常自带兼容字体，Linux 用户需运行
fc-cache -fv刷新字体缓存
Material Icon Theme 是当前最稳的选择
相比 vscode-icons，它更新勤、对新语言（如 .astro、.svelte、.toml）支持更全，且 SVG 图标在高 DPI 屏上更清晰。装完后建议加这几行到 settings.json：
-
"material-icon-theme.folders.color": "#6c5ce7"—— 给文件夹上色，避免和深色侧边栏融成一片 -
"material-icon-theme.hideFoldersArrows": true—— 关掉小箭头，视觉更干净 -
"material-icon-theme.files.associations": { ".env.local": "lock" }—— 把特定文件映射到语义图标（键名必须带点，值必须是图标 ID，不是文件名）
真正容易被忽略的是：图标主题和颜色主题完全解耦，workbench.iconTheme 的值必须是扩展 ID（如 material-icon-theme），不能是显示名（如 “Material Icon Theme”），大小写敏感，也不能多空格或引号外缀字符。
