vscode-icons未生效的五大原因：未手动启用图标主题、工作区设置覆盖用户设置、remote-ssh/wsl环境需单独安装、图标缓存未彻底清除、配置未正确写入settings.json。
图标主题没启用，vscode-icons 就是白纸一张
装完 vscode-icons 后资源管理器里还是默认白纸图标，第一反应不是重装，而是看它有没有被真正“叫醒”。扩展装上 ≠ 自动启用，VSCode 默认不会替你选图标主题。打开命令面板（Ctrl+Shift+P），输入 Preferences: File Icon Theme，回车后从列表里手动选 vscode-icons（注意不是 None 或 Minimal）。如果插件卡片右下角写着“启用”，但点开仍是白纸，大概率就是这步漏了。
workbench.iconTheme 被工作区设置悄悄覆盖了
用户级 settings.json 里写了 "workbench.iconTheme": "vscode-icons"，可项目一打开图标又没了——八成是当前文件夹下的 .vscode/settings.json 把它顶掉了。VSCode 设置优先级是：工作区 > 用户 > 默认，只要项目根目录存在这个文件，它的 workbench.iconTheme 值就会生效。检查方法很简单：关掉所有文件夹，开个空窗口，执行 Preferences: Open Settings (JSON) 看用户设置；再打开项目，用资源管理器展开 .vscode 文件夹，点开 settings.json 查同名项。常见坑是别人 Git 提交的配置里写了 "workbench.iconTheme": null 或空字符串，VSCode 就静默回退到 None，不报错也不提醒。
Remote-SSH 或 WSL 环境里图标根本没装对地方
你在本地装了 vscode-icons，但通过 Remote-SSH 连进服务器后图标还是白的？那是因为 Remote 窗口运行的是远程机器上的 VS Code Server，它需要自己那一份扩展。必须在 Remote 窗口的扩展视图里单独搜索并安装 vscode-icons，本地装的对它完全无效。WSL 同理：如果用 code . 在 WSL 终端启动，图标主题得装在 WSL 的 ~/.vscode-server/extensions/ 下，而不是 Windows 的 %USERPROFILE%\.vscode\extensions。验证方式：打开 Remote 窗口后，按 Ctrl+Shift+P 输入 Extensions: Show Installed Extensions，确认列表里有且启用了 vscode-icons。
重启不彻底，图标缓存根本不刷新
改完 workbench.iconTheme 或启用插件后，只点了“重新加载窗口”？不够。VSCode 的图标资源是进程级缓存，必须完全退出所有 Code 进程才能清掉。Windows 上右键任务栏图标 → “退出”；macOS 打开“活动监视器”，搜 Code 和 Code Helper 全部强制退出；Linux 执行 killall -9 code。之后再启动，图标才会按新配置加载。很多人卡在这一步，反复修改配置却始终没变化，其实只是旧进程还在扛着缓存。
