VSCode的files.associations配置必须使用小写、无空格、VSCode内部注册的语言ID（如yaml、python），而非文件扩展名；键支持*.ext或精确文件名，值须与右下角状态栏显示的language ID完全一致，且需安装对应扩展，工作区级配置优先级高于用户级。
files.associations 配置必须写对语言 ID，不是文件扩展名
VSCode 不会自动把 .xyz 映射成 YAML 或 Python，它只认内部语言 ID。比如你想让所有 .conf 文件用 INI 语法高亮，值必须写 "ini"，而不是 "INI"、"Ini" 或 ".ini"。
常见语言 ID 示例：
-
python（不是py） -
typescript（不是ts） -
yaml（不是YAML、Yaml、yaml-language） -
shellscript（不是bash或sh）
最稳的确认方式：打开一个已正确高亮的同类文件（如 docker-compose.yml），看右下角状态栏点击语言名，弹出的菜单里显示的就是真实 ID；或者按 Ctrl+Shift+P 运行 Developer: Inspect Editor Tokens and Scopes 查看 “Language ID” 字段。
配置位置决定作用范围：用户级 vs 工作区级
改错地方是配置不生效的最常见原因。VSCode 的 files.associations 有明确优先级：
- 文件内注释（如
// @language=python）最高优先级，但极少用 - 工作区级（项目根目录
.vscode/settings.json）次之，适合团队协作或项目专用规则 - 用户级（全局
settings.json）最低，影响所有项目
如果你只想让某个项目里的 .env.local 用 shellscript 高亮，就别动全局设置，直接在项目根目录建 .vscode/ 文件夹，写入：
{
"files.associations": {
".env.local": "shellscript",
"*.conf": "ini"
}
}
这样不会污染其他项目，也能提交到 Git 让队友同步生效。
通配符和文件名匹配有坑：不支持路径层级，大小写敏感
files.associations 的键只匹配文件名，不解析路径。所以这些写法是无效的：
-
"**/.env"→ VSCode 不识别**，只支持*和字面量 -
"ENV"→ 匹配不到.env，因为它是以点开头的隐藏文件名，且大小写敏感 -
"*.LOG"→ 不会匹配app.log，必须写"*.log"
合法写法包括：
-
"*.xyz"（匹配任意位置的xxx.xyz） -
".env.*"（匹配.env.development，但不匹配.env） -
"Dockerfile"（精确匹配文件名，不带通配符）
注意：.env 这种无后缀的纯点文件，只能靠精确匹配或通配 ".env.*"，没法用 "*.env" —— 因为它不是后缀，是完整文件名。
改完不生效？重载窗口 + 检查覆盖关系
修改 settings.json 后，VSCode 不会热更新关联规则。必须：
- 关闭并重新打开该文件，或
- 执行
Ctrl+Shift+P→Developer: Reload Window
如果仍不生效，重点排查：
- 有没有项目级
.vscode/settings.json覆盖了你的配置？用命令面板运行Preferences: Open Settings (JSON)看当前加载的是哪个文件 - 有没有插件（比如某些 DSL 插件）注册了自己的语言 ID 并劫持了关联？临时禁用插件测试
- 文件是否已被打开过？VSCode 有时会缓存旧的语言模式，关掉再开
真正容易被忽略的一点：语言 ID 写错时 VSCode 不报错，只是静默失效。务必用状态栏或 Inspect Editor Tokens 反向验证，而不是只信自己写的配置。
