VSCode不支持按文件夹名设置背景色，仅能通过Material Icon Theme的folders.associations映射图标类型并配合folders.color统一染色实现视觉区分，需同时配置二者且值必须符合官方图标列表规范。
VSCode 本身不支持按文件夹名称设置颜色，但可通过 Material Icon Theme 的 folders.associations 配合图标着色实现视觉区分效果——本质是换图标，不是真改背景色。
为什么直接搜“文件夹颜色插件”会踩坑
VSCode 没有原生的「文件夹背景色」配置项，workbench.colorCustomizations 也管不到单个文件夹节点。网上所谓“文件夹颜色插件”，多数是混淆了「图标色」和「背景色」，或依赖已废弃的 CSS 注入方式（在 VS Code 1.80+ 版本中失效甚至报错）。真正稳定可用的路径只有一条：用图标主题的语义化图标 + 主色覆盖。
material-icon-theme.folders.associations 怎么写才生效
这个配置不是绑定颜色，而是把某个文件夹名映射到一个预设图标类型（比如 src → src 图标），再通过 folders.color 统一染色。必须同时配齐两部分：
-
folders.associations中的键是文件夹名（不带路径，如"src"、"assets"），值是该主题支持的图标标识符（如"src"、"folder"、"dist"）——不能乱写，得查 Material Icon Theme 官方图标列表 -
folders.color只接受十六进制颜色值（如"#4285f4"），不支持rgb()或变量 - 整个配置必须放在
settings.json的顶层，不能嵌套在其他对象里
示例：
"material-icon-theme.folders.associations": {
"src": "src",
"tests": "test",
"docs": "docs"
},
"material-icon-theme.folders.color": "#28a745"
常见失效场景与绕过方法
即使配置正确，也可能看不到颜色变化，原因集中在三处：
- 工作区（
.vscode/settings.json）里写了"workbench.iconTheme": null或空字符串，会直接禁用所有图标 - 当前启用的图标主题不是
material-icon-theme，而是vscode-icons或别的——只有前者支持folders.color - 文件夹名含空格或特殊字符（如
my components），folders.associations不识别，得改名为components或用folders.associations+files.associations组合间接处理
如果只是想让某个文件夹“看起来突出”，比颜色更可靠的做法是：用 "material-icon-theme.folders.associations": { "node_modules": "node" } 换成醒目的 Node.js 图标，再配合 "material-icon-theme.folders.color": "#e8433c" 加红——图标本身比纯色块更容易被眼睛捕获。
真正麻烦的不是怎么配，而是多层 settings（用户 / 工作区 / 远程）叠加时，folders.color 很容易被静默覆盖。每次改完记得右下角看有没有黄色感叹号，那是 JSON 格式或配置冲突的唯一提示。
