VSCode需手动配置files.associations以关联冷门/自定义后缀到正确language-id，注意ID大小写、作用域优先级及通配符限制（仅支持*.ext和完整文件名匹配）。
文件后缀没被 VSCode 关联到对应语言模式
VSCode 不会自动把所有冷门或自定义后缀映射到语法高亮/智能提示所需的语言模式，比如 .conf、.env.local、.yml.dist 这类文件常被识别为 Plain Text，导致没有缩进规则、无补全、LSP 不触发。
- 检查右下角状态栏：点击当前语言标识（如
Plain Text），选择「Configure File Association for '.xxx'」 - 该操作会向
settings.json写入一条"files.associations"规则，格式为"*.xxx": "language-id" - 注意
language-id必须是 VSCode 内部使用的 ID，不是文件扩展名——比如 YAML 对应yaml，不是yaml或YAML；TypeScript React 是typescriptreact，不是tsx - 若扩展提供了新 language-id（如
dotenv来自 DotENV 扩展），需先安装扩展，重启 VSCode 后再配置，否则下拉列表里不会出现
全局关联被工作区设置覆盖
你明明在用户设置里配了 "*.log": "plaintext"，但打开某个项目时 log 文件却显示为 Log 模式——大概率是该工作区的 .vscode/settings.json 里也写了 files.associations，且它优先级更高。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行「Preferences: Open Workspace Settings (JSON)」确认是否重复定义 - 工作区设置中的
files.associations会完全替换用户级设置，不是合并；若只想补充而非覆盖，得把用户级全部规则复制一份过去再加新条目 - 临时验证方式：用
code --disable-extensions --user-data-dir=/tmp/vscode-test启动干净实例，排除扩展干扰
通配符匹配失败：星号位置和大小写敏感
写成 "config.*": "ini" 或 "*.CONFIG": "ini" 都不会生效——VSCode 的 files.associations 只支持前缀匹配（*.ext）和完整文件名匹配（filename），不支持中间带 *，且 Windows 下虽不区分扩展名大小写，但配置项本身必须小写。
{
"files.associations": {
"*.conf": "ini",
"*.env": "dotenv",
"Dockerfile": "dockerfile",
".editorconfig": "editorconfig"
}
}
-
"config.*"❌ 不匹配config.dev；正确写法是"*.dev": "ini"（如果所有.dev都该用 ini 模式） -
"*.ENV"❌ 在 macOS/Linux 下无效；统一用小写"*.env" - 文件名匹配（不含点）如
"Makefile"或"Procfile"是精确匹配，大小写敏感
语言模式切换后插件未响应
手动点击右下角切换成 jsonc 后，Prettier 仍不格式化，ESLint 也不报错——说明语言模式变了，但相关插件没监听这个变化，或者插件本身不支持该 language-id。
- 运行命令「Developer: Toggle Developer Tools」，在 Console 里输入
monaco.editor.getLanguages()查看当前加载的语言列表，确认目标language-id是否在其中 - 某些插件（如旧版 Auto Rename Tag）只监听
html、vue，不监听erb或astro；得查插件文档确认支持范围 - 部分 LSP 插件（如 rust-analyzer）依赖
files.associations在打开时就确定语言，中途手动切换可能不会重建连接，需关闭再重开文件
