VSCode不支持项目图标，所谓“自定义项目图标”实为通过图标主题+文件夹/文件名关联规则实现：需先安装并启用material-icon-theme或vscode-icons扩展，再在settings.json中配置workbench.iconTheme为对应ID（如"material-icon-theme"），并用material-icon-theme.folders.associations或vsicons.associations.folders精确映射文件夹名（如"client":"application"），最后执行Developer: Reload Window刷新缓存。
VSCode 本身不支持“项目图标”这个概念——它只管文件和文件夹，没有“项目级图标”配置项。所谓“自定义项目图标”，实际是通过图标主题 + 文件夹关联规则，让项目根目录下的特定文件（如 package.json、tsconfig.json）或文件夹（如 src、docs）显示专属图标，从而在资源管理器中快速识别项目类型。
为什么改了 workbench.iconTheme 还没项目图标
因为 VSCode 不会自动把扩展装完就当成当前图标主题；它只安装，不激活。常见卡点：
- 扩展已安装但未启用：去扩展面板 → 切换到「已启用」标签页，确认
vscode-icons或material-icon-theme前面有对勾 - 没走命令面板激活：必须按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并执行Preferences: File Icon Theme，再选中对应主题 -
workbench.iconTheme的值写错：必须和扩展 ID 完全一致，比如"vscode-icons"（不是"vscode-icons-theme"，也不是"VsCode Icons"） - 改完没重载窗口：即使保存了
settings.json，也得执行Developer: Reload Window才能刷新图标缓存
material-icon-theme.folders.associations 怎么配才生效
这个字段控制的是**文件夹名**对应的图标，不是项目名。例如你想让所有叫 client 的文件夹显示电脑图标、server 显示服务器图标，就得这么写：
"material-icon-theme.folders.associations": {
"client": "application",
"server": "server",
"docs": "docs"
}
注意：
- 键名是文件夹的**精确名称**，不支持通配符或正则，
"cli*"或"client/"都无效 - 值（如
"application"）必须是material-icon-theme实际支持的图标 ID，查法：打开扩展页面 → 点「Contributions」→ 拉到iconDefinitions区域找名字 - 如果用了
vscode-icons，别用这个字段——它用的是vsicons.associations.folders，写错字段名等于白配 - 配完记得重载窗口，否则新规则不会加载
如何让 vite.config.ts、.env.local 这类文件显示图标
主流图标主题默认只匹配最后一段后缀（.ts、.local），前面的修饰部分被忽略。解决方法是手动映射：
- 对多点后缀文件，用 glob 模式（仅限
material-icon-theme）：".env.*": "config"可覆盖.env.development，但不覆盖.env.dev.local - 对带语言后缀的配置文件，推荐按完整文件名配：
"vite.config.ts": "typescript"、"astro.config.mjs": "astro" - 图标 ID 大小写敏感：
"Config"≠"config"，写错 VSCode 不报错，但图标就是不出现 - 别往
files.associations里写图标映射——那是干语法高亮用的，写进去只会让.env.local被当成 shell 脚本高亮，图标照样空白
最常被忽略的一点：图标主题的加载顺序依赖 VSCode 启动时读取的配置快照。哪怕你改对了所有字段，只要没重载窗口，编辑器就仍按旧快照渲染——这不是 bug，是设计机制。
