VSCode图标主题需手动启用且依赖文件扩展名识别。安装vscode-icons或Material Icon Theme后，须通过命令面板选择图标主题，并检查workbench.iconTheme设置及工作区覆盖问题。
VSCode 的资源管理器图标主题不会自动生效，必须手动启用且依赖文件扩展名识别——光装插件不配置等于白装。
安装支持图标主题的扩展
VSCode 自带图标主题非常简陋，需安装第三方扩展。最常用、维护活跃的是 vscode-icons（官方推荐）或 Material Icon Theme。两者都支持自定义、高分辨率图标和语言特有文件类型映射。
- 在扩展面板搜索
vscode-icons，点击安装并重载窗口 - 安装后默认不启用，需手动开启（见下一步）
- 若已安装其他图标主题（如
Minimal Icons），建议禁用，避免冲突
启用图标主题的正确方式
图标主题不是靠“启用扩展”就自动工作的，它必须被显式设置为当前激活的主题。VSCode 会忽略未在配置中指定的图标主题。
- 按下
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Preferences: File Icon Theme - 从下拉列表中选择
VS Code Icons或Material Icon Theme - 无需重启，资源树图标会立即刷新（如果没变，请检查是否误选了
None）
图标不显示？排查常见断点
即使启用了主题，仍可能看到默认文件夹/文件图标，问题往往出在识别逻辑上。
-
vscode-icons默认只对已知扩展名（如.js、.ts、.json）启用图标；自定义后缀（如.api.ts）需手动映射 - 检查设置中是否有冲突项：
workbench.iconTheme被设为null或空字符串，会强制关闭图标 - 某些工作区设置了
"workbench.iconTheme": "null"在.vscode/settings.json中，会覆盖全局设置 - 图标主题不作用于未保存的临时文件（
Untitled-1）或无扩展名的文件（如Dockerfile需确保文件名准确，不是dockerfile）
按需定制图标映射（进阶）
如果你的项目使用非标后缀（如 .page.tsx、.schema.gql），默认图标主题无法识别，需手动绑定到已有图标类型。
打开设置（Ctrl+, ），搜索 icon custom，点击 Edit in settings.json，添加类似配置：
{
"vsicons.associations.files": [
{
"icon": "react_ts",
"extensions": ["page.tsx", "layout.tsx"],
"format": "svg"
},
{
"icon": "graphql",
"extensions": ["schema.gql", "query.gql"],
"format": "svg"
}
]
}
注意：vscode-icons 使用 vsicons.associations.files，而 Material Icon Theme 对应的是 material-icon-theme.files.associations，参数名不同，不能混用。
图标主题的底层逻辑是“扩展名 → 图标ID → SVG 渲染”，任何一环断开都会回退到默认样式；最常被忽略的是工作区级 settings.json 的覆盖行为，以及大小写敏感的文件名匹配（比如 README.md 有图标，但 readme.md 可能没有）。
