需先安装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，哪个图标显示在前，取决于插件内部的匹配顺序，没法靠配置强行干预。