minimal icons装了不显示图标,因其默认禁用且不支持workbench.icontheme热更新,需手动开启minimal-icons.enable、禁用冲突主题、还原字体栈并检查工作区设置覆盖。

Minimal Icons 为什么装了不显示图标
Minimal Icons 是专为“视觉降噪”设计的图标主题,它默认不显示任何彩色或具象图标,只用极细线条勾勒文件类型轮廓。但它的机制和 Material Icon Theme 完全不同:它不支持 files.associations 映射,也不读取自定义颜色配置,甚至不响应 workbench.iconTheme 的动态热更新。
常见错误现象包括:装完插件后资源管理器仍是空白页图标、命令面板执行 Preferences: File Icon Theme 选中 Minimal Icons 后无反应、或者图标突然全部消失(其实是被设为“不可见线条”)。
- 必须手动在设置里搜索
Minimal Icons,找到minimal-icons.enable并设为true - 确认没同时启用其他图标主题——VSCode 不报错,但
workbench.iconTheme值会被后者覆盖,且 Minimal Icons 不会主动写入该字段 - 如果之前用过
vscode-icons或Material Icon Theme,它们可能残留"workbench.iconTheme": "vscode-icons"在settings.json中,需手动删掉
如何让 .env、.gitignore 这类文件也走极简线条
Minimal Icons 对隐藏文件(以 . 开头)默认使用统一的「齿轮+短线」图标,但不会区分 .env 和 .gitignore。它不提供 files.associations 配置入口,所以你不能像 Material Icon Theme 那样写映射规则。
但它支持一个隐式开关:minimal-icons.hideDotfiles。设为 false 后,所有点文件会显示为带斜杠的「文档页」图标(依然是黑白单线),而不是直接隐藏或混用齿轮。
- 打开设置(
Ctrl+,),搜索minimal-icons.hideDotfiles - 取消勾选,或在
settings.json中添加:"minimal-icons.hideDotfiles": false - 无需重启,刷新资源管理器即可看到变化
图标变方块或线条断裂?不是插件问题,是字体没对上
Minimal Icons 渲染依赖 VSCode 内置的 codicon 字体族,不调用系统 Nerd Fonts 或外部 SVG。一旦终端或编辑器字体设置干扰了图标字体 fallback,就会出现线条中断、半截图标、或方块 □。
典型触发场景:你改过 editor.fontFamily,比如设成了 'Fira Code', 'monospace',而 Fira Code 默认不包含 codicon 符号集。
- 在设置中搜索
editor.fontFamily,把它还原成默认值:'-apple-system, BlinkMacSystemFont, "Segoe UI", Ubuntu, Cantarell, sans-serif' - 或显式保留图标字体优先级:
'codicon, -apple-system, BlinkMacSystemFont, "Segoe UI", Ubuntu, sans-serif' - Windows 用户若启用了「自定义 DPI 缩放」(如 112%),建议调回 100% 或 125%,非整数缩放会导致线条抗锯齿失效
工作区级图标主题切换失败?检查 .vscode/settings.json 是否静默覆盖
Minimal Icons 在工作区(project-level)启用时,容易被 .vscode/settings.json 里残留的旧配置劫持。它不像其他图标主题那样会自动注入配置项,而是完全依赖全局设置生效。
如果你在某个项目里发现图标恢复成默认文档页,但其他项目正常,大概率是该工作区的 settings.json 里写了 "workbench.iconTheme": "null" 或 "workbench.iconTheme": "" —— VSCode 把空字符串当合法值,于是禁用所有图标主题。
- 打开项目根目录下的
.vscode/settings.json - 删掉整行
"workbench.iconTheme": ...(哪怕值是null或空字符串) - 保存后执行
Developer: Reload Window,不要只靠快捷键切换











