VSCode图标主题未启用导致文件图标不显示；需手动通过命令面板选择非None主题、安装并重载对应扩展、开启Explorer: Show Icons开关，三者缺一不可。
图标主题没启用，装了等于白装
VSCode 默认不激活任何图标主题，哪怕你已安装 vscode-icons 或 material-icon-theme，只要没手动点选，文件名前就只会显示空白或通用文档图标。这不是插件失效，是主题“压根没上场”。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并执行Preferences: File Icon Theme - 从下拉列表中选一个非
None的主题，比如vscode-icons、Minimal或seti - 选完立刻生效，无需重启；若仍无变化，说明问题不在这一步
扩展没装或没重载，配置静默失败
workbench.iconTheme 配置项依赖对应扩展存在并激活。如果只在 settings.json 里写了 "workbench.iconTheme": "vscode-icons" 却没装扩展，VSCode 会忽略该设置，图标照样不显示——且不报错、不提示。
- 点击左侧扩展图标（
Ctrl+Shift+X），搜索vscode-icons，认准作者是robertohuertasm的官方版本 - 安装后，右下角提示“已安装”，但必须点“重新加载”按钮（或关闭再打开 VSCode），否则扩展不会初始化
- 若之前装过冲突图标扩展（如同时启用了
material-icon-theme和vscode-icons），禁用其中一个再测试
Explorer: Show Icons 开关被关了
这是最隐蔽的“总闸”：即使主题正确、扩展激活，只要这个全局开关关闭，所有文件图标一律不渲染。它独立于主题设置，且默认开启，但极易被误关。
- 按
Ctrl+,打开设置，搜索show icons - 确认
Explorer: Show Icons处于勾选状态 - 检查
settings.json（用Preferences: Open Settings (JSON)打开），删掉或修正这两类错误配置："workbench.iconTheme": null或"workbench.iconTheme": ""
文件没被识别为对应语言，图标主题无从匹配
图标主题靠语言 ID 匹配图标，不是靠文件后缀。比如 .env 文件若被识别为 plaintext，而当前主题只给 shellscript 提供专属图标，那它就只能显示默认文档图标。
- 打开一个有问题的文件，看右下角状态栏显示的语言模式（如
Plain Text）；若显示不对，点它手动切换为正确语言（如Shell Script） - 验证是否生效：切换后图标若立刻出现，说明是
files.associations配置问题 - 在
settings.json中添加或修正关联，注意语法严格："*.env": "shellscript"（键带引号、值小写、无空格），不要写成js或jsx这类非法语言 ID
真正卡住的往往是第二步和第三步的组合：扩展装了但没重载 + 总开关被关。很多人改完 settings.json 就以为万事大吉，却忘了扩展本身要“活过来”，也忽略了那个不起眼的勾选框。这两个动作缺一不可，且顺序不能颠倒。
