需先安装vscode-icons插件，再执行Icons: Activate Icons命令启用；若图标未显示，检查workbench.iconTheme设置是否为"vscode-icons"，并确保未与其他图标主题冲突。
如何安装并启用 vscode-icons 插件
vscode-icons 不是 VSCode 内置功能，必须通过扩展市场安装。直接在扩展面板搜索 vscode-icons，认准作者为 Roberto Huerta 的官方插件（图标为紫色方块加白色“i”），点击“安装”即可。
安装完成后需手动启用：按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板，输入并执行 Icons: Activate Icons。此时文件资源管理器中的图标才会生效。
- 不执行激活命令，插件装了也看不到任何图标变化
- 如果已启用但图标未更新，尝试重启 VSCode 或执行
Icons: Update Icons - 某些工作区可能禁用了图标主题，检查当前窗口右下角状态栏是否显示
vscode-icons，没显示说明未激活
为什么文件图标没变？常见配置冲突点
vscode-icons 依赖 VSCode 的 workbench.iconTheme 设置生效，但该设置容易被其他插件或用户配置覆盖。
打开设置（Ctrl+,），搜索 icon theme，确认右侧下拉菜单选中的是 vscode-icons，而不是默认的 vs-seti 或空值。也可以直接编辑 settings.json，确保包含这一行：
"workbench.iconTheme": "vscode-icons"
- 如果同时装了
Material Icon Theme，两者会冲突，必须卸载其一 - 工作区级
.vscode/settings.json可能覆盖全局设置，需检查该文件是否误设为null或其他主题 - 部分远程开发（SSH/Containers）场景下，插件需在远程环境中单独安装并激活
如何自定义特定文件类型的图标
vscode-icons 支持通过 vsicons.associations.files 和 vsicons.associations.folders 手动映射扩展名或文件夹名到图标。
例如，想让所有 .env.local 文件显示齿轮图标，可在 settings.json 中添加：
"vsicons.associations.files": [
{
"icon": "gear",
"extensions": ["env.local"],
"format": "svg"
}
]
-
icon值必须来自 vscode-icons 官方支持的图标名（如gear、database、config），不是任意字符串 - 扩展名不带点，写
"env.local"，不要写".env.local" - 修改后需执行
Icons: Update Icons或重启 VSCode 才生效 - 文件夹映射用
vsicons.associations.folders，语法类似，但icon值需是文件夹类图标（如src、tests）
图标显示异常或模糊？和 SVG 渲染有关
vscode-icons 默认使用 SVG 图标，但在某些系统（尤其是旧版 Windows 或高 DPI 缩放非 100% 时）可能出现锯齿、错位或加载延迟。
- 可临时切换为 PNG 版本：在
settings.json中添加"vsicons.presets.png": true - 若启用了
vsicons.presets.foldersAllDefaultIcon，会导致所有文件夹统一用默认图标，失去语义区分，慎开 - 极少数字体渲染设置（如
workbench.fontAliasing）会影响 SVG 图标边缘，一般无需调整
真正难调的其实是项目结构复杂时的图标优先级——比如同时存在 package.json 和 pnpm-lock.yaml，哪个图标显示在前，取决于插件内部的匹配顺序，没法靠配置强行干预。
