VSCode自定义文件图标依赖vscode-icons扩展及settings.json配置；必须手动启用"workbench.iconTheme": "vscode-icons"，并通过vsicons.associations.files映射自定义后缀，修改后需Developer: Reload Window生效。
VSCode 自定义文件图标依赖哪些扩展和配置
VSCode 本身不提供文件图标定制能力，必须靠第三方扩展实现。最主流、维护活跃的是 vscode-icons，它通过修改工作区的 settings.json 和（可选）icon-theme 配置生效。
关键点：不是装了扩展就自动显示图标——你得手动启用它，并确保没有其他图标主题冲突。
-
vscode-icons是唯一需要安装的扩展（在 Extensions 商店搜这个名字，认准作者vscode-icons-team） - 安装后必须在设置里显式启用：
"workbench.iconTheme": "vscode-icons" - 如果已启用
material-icon-theme或其他图标主题，要先禁用或卸载，否则图标不会切换 - 不建议手动编辑
icons.json或覆盖内置图标的 SVG 文件——这些改动会在更新后丢失，且易引发渲染异常
如何为自定义文件后缀添加图标
默认情况下 vscode-icons 支持常见后缀（如 .ts、.md），但遇到内部 DSL、构建产物或私有配置文件（比如 .env.local、.yml.dist）时，需要手动映射。
做法是在用户或工作区 settings.json 中添加 vsicons.associations.files 或 vsicons.associations.folders 配置项。
- 匹配单个文件：
"vsicons.associations.files": [{ "icon": "react", "extensions": ["jsx", "tsx"] }] - 匹配带前缀/后缀的文件：
"extensions": ["*.config.js"]是合法写法，但注意 VS Code 不支持通配符嵌套（*.config.*无效） - 图标名必须是
vscode-icons内置的图标 ID（可在其 GitHub 仓库的src/icons/目录查到，如docker、git、settings） - 改完保存后，需重启 VSCode 窗口（CMD/CTRL+SHIFT+P →
Developer: Reload Window）才能生效
为什么有些文件图标没变？常见排查路径
图标未生效通常不是配置写错了，而是被更高优先级规则覆盖或路径识别失败。
- 检查当前工作区是否启用了
icon-theme：打开命令面板（CMD/CTRL+SHIFT+P），输入Preferences: Open Settings (JSON)，确认"workbench.iconTheme"值是"vscode-icons"，而不是null或空字符串 - 确认文件是否被
files.associations影响：比如你把.js关联到了jsonc语言模式，vscode-icons就会按 JSON 图标渲染，而非 JS 图标 - 扩展版本太旧：v13+ 开始弃用
vsicons.presets类配置，若你还留着"vsicons.presets.javascript": false这类旧字段，可能干扰新规则加载 - 文件在
node_modules或.git下：默认会被图标扩展忽略（性能考虑），需手动开启"vsicons.projectDetection.disableDetect": true并配合vsicons.associations强制指定
图标颜色和尺寸能调吗
不能直接调。VSCode 的图标系统只接受 SVG 资源路径和名称映射，不暴露 fill color、scale、opacity 等 CSS 层控制接口。
如果你看到某些主题里图标带颜色，那其实是图标 SVG 文件本身自带 fill 属性（比如 vscode-icons 的 folder-type-src.svg 里写了 fill="#4ECDC4"），不是 VSCode 渲染层动态上色。
- 想改颜色？只能 fork
vscode-icons项目，修改对应 SVG 的fill值，再打包成本地扩展安装——但每次上游更新都要重新 merge - 想放大图标？VSCode 没提供缩放 API；部分用户用自定义 CSS 注入（如
vscode-custom-css扩展）强行 transform，但该方式在 VSCode 1.80+ 已被限制，且不稳定 - 真正可控的只有“显示/隐藏”：比如关掉
"vsicons.presets.foldersAllDefaultIcon"让文件夹回归系统默认样式
最常被忽略的一点：图标映射只对「文件名后缀」或「完整文件名」生效，不识别内容特征。比如你希望所有含 test 的文件都显示 ? 图标，VSCode 图标机制做不到——那属于文件内容语义，得靠自定义语言模式 + Decoration API，和图标主题无关。
