workbench.icontheme 字段必须在 settings.json 中配置为扩展 id（如 "material-icon-theme"），仅图形界面选择不生效；需配合 material-icon-theme 专属字段实现高级图标映射，注意用户级与工作区级配置优先级及 json 格式正确性。
直接写 workbench.iconTheme 字段就行
VSCode 的图标主题不是靠 UI 界面“启用”就完事的，真正起效的是 workbench.iconTheme 这个配置项。它必须出现在 settings.json 里，值是扩展的 ID（不是显示名），比如 "material-icon-theme"。如果只在图形设置里点选但没保存到 JSON，换设备或重装后就会失效。
常见错误现象：
- 图标没变化，但命令面板里明明选了 “Material Icon Theme”
- 工作区里图标正常，用户设置里却没生效 → 很可能是工作区
.vscode/settings.json覆盖了用户级配置 - 出现方块 □ → 不是图标配置问题，而是系统缺少 Nerd Fonts（图标字体支持）
material-icon-theme 的关联配置要单独加
仅设 workbench.iconTheme 只能启用基础图标，想让 Dockerfile 显示容器图标、infra/ 文件夹显示云图标，得额外加扩展专属字段。这些字段不会被 VSCode 原生识别，但 material-icon-theme 扩展自己会读取。
实操建议：
- 在同个
settings.json里紧挨着workbench.iconTheme加上："material-icon-theme.files.associations"或"material-icon-theme.folders.associations" - 值必须是对象，不能是数组；键支持通配符（如
"*.config.js"），值必须是图标类型名（如"config"、"docker"） - 图标类型名要去 官方文档 查，拼错就回退成默认图标
用户设置 vs 工作区设置，优先级容易搞反
VSCode 有两层 settings.json：用户级（全局生效）和工作区级（仅当前项目）。图标主题配置写在哪一层，决定了它的作用范围。
使用场景判断：
- 想所有项目都用 Material 图标 → 改用户级
settings.json（命令面板输入Preferences: Open Settings (JSON)） - 只想某个项目隐藏
node_modules图标 → 在该项目根目录.vscode/settings.json里加"material-icon-theme.hidesExplorerArrows": true - 团队共用一套图标规则 → 把
.vscode/settings.json提交进 Git，但注意别把个人偏好（如字体大小）也混进去
改完不生效？先检查这三件事
图标配置看似简单，但 VSCode 的加载逻辑会让一些细节卡住效果：
- 确认扩展已安装且启用：在扩展面板搜
material-icon-theme，状态栏右下角应有图标主题提示 - 检查引号和逗号：JSON 格式严格，
"workbench.iconTheme": "material-icon-theme",结尾多一个逗号、少一个引号都会导致整份配置失效 - 重启资源管理器：改完保存后，不用重启 VSCode，但可以右键侧边栏“刷新”或按
Ctrl+R（Windows）强制重载文件树
最常被忽略的是扩展 ID 和显示名混淆——“Material Icon Theme” 是显示名，ID 是 material-icon-theme，少个连字符或大小写错误都会让配置静默失败。
