VSCode装完图标插件不生效，是因为未手动启用主题：必须执行Preferences: Configure Icons选择主题，或在settings.json中设置workbench.iconTheme为对应ID（如"material-icon-theme"），否则默认回退到vs-seti内置图标。
装完插件不生效，不是插件有问题，而是 VSCode 压根没启用图标主题——这是 90% 用户卡住的地方。
为什么装了 Material Icon Theme 或 vscode-icons 还是显示默认方块图标？
VSCode 的图标主题和颜色主题完全解耦：安装插件 ≠ 启用主题。插件只提供图标资源包，workbench.iconTheme 设置为空或未指定时，VSCode 默认回退到内置的 vs-seti（就是那个带小箭头的空白方块）。你看到的“没变化”，其实是它根本没切换过去。
- 检查
settings.json是否存在"workbench.iconTheme": "material-icon-theme"或"vscode-icons"这行配置 - 命令面板中执行
Preferences: Configure Icons（不是Preferences: File Icon Theme，后者在新版中已弃用） - 如果弹出列表为空，说明插件没正确安装——去扩展页搜全名，确认状态是 Enable 而非灰色或 Disabled
如何用命令行批量安装并启用图标主题？
适合多环境（本地/WSL/Remote SSH）或写入初始化脚本的场景。注意：code --install-extension 命令的执行位置决定安装目标：终端在本地运行 → 装本地；终端连着 Remote SSH → 装远端。
- 安装
Material Icon Theme：code --install-extension PKief.material-icon-theme - 安装
vscode-icons：code --install-extension robertohuertas.vscode-icons - 安装后必须手动启用：编辑
settings.json，添加"workbench.iconTheme": "material-icon-theme"（值必须与插件 ID 中的主题名一致，比如vscode-icons对应"vscode-icons"） - 远程环境慎用
--force：某些插件在 Remote 容器里依赖 Node.js 环境，强制安装可能失败
material-icon-theme 的常用自定义配置项有哪些？
这类配置不会出现在图形设置界面里，必须手写进 settings.json，且只对当前主题生效。换主题就得重配。
-
"material-icon-theme.folders.color": "#4285f4"—— 改文件夹图标的主色（支持十六进制、rgb、named color） -
"material-icon-theme.hidesFolders": true—— 隐藏所有文件夹图标，只留文件图标（极简党常用） -
"material-icon-theme.files.associations": { "*.log": "log", "Dockerfile": "docker" }—— 强制将特定文件名映射到图标类型，绕过默认扩展名匹配逻辑 -
"material-icon-theme.showUpdateMessage": false—— 关闭每次升级后的提示弹窗，避免干扰
哪些情况会导致图标“突然消失”？
不是插件崩了，而是设置被覆盖或环境受限。最常被忽略的是多层 settings 叠加和沙盒限制。
- 工作区级
.vscode/settings.json里写了"workbench.iconTheme": null，会覆盖用户级设置 - Linux 下用 Snap 安装的 VSCode：因沙盒机制，无法读取部分字体路径，图标渲染失败；建议改用
.deb或官方 tarball 版本 - 绿色版/便携版 VSCode：某些打包版本禁用了扩展加载机制，图标主题无法注入资源
- 插件图标本身不可改：VSCode 不允许运行时覆盖插件 package.json 里声明的
icon字段，所谓“美化插件图标”只能靠图标主题统一 fallback，不能单独动某个插件的图标
真正麻烦的从来不是“怎么装”，而是谁在静默覆盖你的 workbench.iconTheme —— 多环境、多工作区、多安装方式混用时，这个字段最容易被不同层级的 settings 冲突掉。
