VSCode图标主题必须先安装扩展（如material-icon-theme或vscode-icons），再在settings.json中配置"workbench.iconTheme"为对应扩展ID，否则配置无效；未生效需检查扩展是否启用、ID是否拼写正确、是否在文件夹模式下运行。
图标主题必须先装扩展，再配 workbench.iconTheme
VSCode 本身不带任何文件图标，workbench.iconTheme 这个配置项只是“开关”和“选择器”，它本身不提供图标资源。没装对应扩展，写什么都白搭。
常见错误现象：settings.json 里写了 "workbench.iconTheme": "material-icon-theme"，但资源管理器还是小方块图标——大概率是扩展根本没装，或者装了但被禁用。
- 打开扩展面板（
Ctrl+Shift+X），搜material-icon-theme或vscode-icons，认准发布者（前者是 Equinusocio，后者是 Roberto Huertas） - 点「安装」，装完看右下角状态栏是否显示图标主题名；不显示，就点扩展面板里的「启用」按钮
- 值必须和扩展 ID 完全一致：
"material-icon-theme"≠"Material Icon Theme"≠"material-theme"
material-icon-theme.files.associations 怎么写才生效
默认图标覆盖不了所有文件，比如 .env.local、Dockerfile.prod、pnpm-lock.yaml 这类非标准命名，得手动映射。这个配置只在用了 material-icon-theme 时有效，vscode-icons 对应的是 vsicons.associations.files。
示例（加到 settings.json 中）：
"material-icon-theme.files.associations": {
".env.local": "gear",
"Dockerfile.*": "docker",
"pnpm-lock.yaml": "lock"
}
- 键支持通配符
*和?，但不支持正则；Dockerfile.*匹配Dockerfile.dev，但Dockerfile.*.prod不行 - 值必须是该图标主题已定义的图标名，比如
gear、docker、lock，不能随便写"config"或"env"（会静默忽略） - 改完不用重启，但要重载窗口（
Ctrl+Shift+P→Developer: Reload Window）才能刷新已有文件夹中的图标
为什么文件夹没图标？检查 folders.associations 和识别逻辑
文件夹图标不是靠名字硬匹配的，而是靠内容特征识别：有 package.json → 显示 JS 图标，有 pyproject.toml → Python 图标，空文件夹或无特征文件夹就用默认文件夹图标。
如果想强制让某个文件夹显示特定图标（比如把 docs 文件夹设为文档图标），得用 folders.associations：
"material-icon-theme.folders.associations": {
"docs": "docs",
"scripts": "tools"
}
- 值同样必须是主题内置的图标名，查法：打开插件 GitHub 页面或 VSCode 扩展详情页的
iconDefinitions部分 -
vscode-icons的文件夹映射字段是vsicons.associations.folders，语法一样但图标名不同（比如"src"对应"folder-src"） - 别同时启用多个图标扩展，它们会冲突，只保留一个测试
远程开发（SSH/WSL/Containers）下图标不显示？扩展要装在远端
本地装了 material-icon-theme，但通过 Remote-SSH 打开项目，资源管理器还是默认图标——因为图标扩展必须安装在远程环境中，本地装了没用。
- 连接远程后，在扩展面板顶部选「Remote: SSH」或「Remote: Containers」标签页
- 再搜
material-icon-theme并安装（注意右下角状态栏会显示SSH: xxx） - 装完执行
Preferences: File Icon Theme命令，选中主题；或者直接改远程端的settings.json - 如果远程是 WSL，还要确认 WSL 发行版里 VSCode Server 版本 ≥ 1.70，太老的版本不支持完整图标缓存
最常被忽略的一点：图标主题依赖工作区上下文。单个文件（File > Open File）模式下，资源管理器根本不加载图标主题，必须用 File > Open Folder 才能生效。
