VSCode不靠后缀自动识别语言,而是依赖files.associations配置和内置映射;若.env.example未高亮,说明被识别为plaintext而非dotenv,需通过Change Language Mode确认,并在settings.json中添加".env.*": "dotenv"等关联规则。

文件后缀没高亮?先查 VSCode 是否识别了语言模式
VSCode 不是靠文件后缀“自动猜”语言,而是查 files.associations 配置 + 内置映射表。如果打开一个 .env.example 文件,发现全是灰色文字、没有变量高亮,大概率是它被识别成了 plaintext 而非 dotenv。
- 快捷键 Ctrl+Shift+P(macOS 是 Cmd+Shift+P),输入
Change Language Mode回车,看右下角当前语言名 —— 这是真实生效的语言模式,不是文件后缀 - 如果显示
Plain Text,说明 VSCode 没关联该后缀,或你装的扩展没注册对应规则 - 内置支持的后缀有限:
.js→javascript,.ts→typescript,但.cts、.mts、.env.local等默认不识别
手动关联后缀:改 settings.json 最直接
全局设置或工作区设置里加 files.associations,这是最稳定、优先级高于扩展的方式。注意格式是 "*后缀*": "语言id",语言 ID 必须和 VSCode 内部一致(比如不是 python 而是 python,但 dotenv 就是 dotenv)。
- 打开设置(Ctrl+,),右上角点 {} 进入
settings.json - 加入类似这样的片段:
{
"files.associations": {
"*.env": "dotenv",
".env.*": "dotenv",
"*.cts": "typescript",
"*.mts": "typescript"
}
}
-
*.env匹配所有.env后缀文件;.env.*匹配.env.development这类 —— 两者要都写,因为 VSCode 的 glob 不支持**通配 - 语言 ID 可在
Change Language Mode弹窗里看到,比如选中Python,实际填的是python;选Shell Script,填的是shellscript - 改完保存,重新打开文件才生效(已打开的文件不会自动刷新语言模式)
扩展自带的关联可能被覆盖或失效
像 DotENV、ES7+ React/Redux/React-Native snippets 这类扩展会声明自己的文件关联,但 VSCode 的加载顺序和优先级会让它们容易被用户配置覆盖,或者根本没触发。
- 检查扩展是否启用:禁用其他语言相关扩展,只留目标扩展,再试一次
Change Language Mode - 有些扩展要求你先打开一个匹配文件才能激活(比如打开
.env才载入dotenv支持),纯配置不触发 - 扩展声明的关联路径写错很常见:比如写成
"*.env.*"想匹配.env.local,但 VSCode 实际只认.env.*(开头不能带*) - 如果用了多根工作区,
settings.json在工作区根目录下才对该项目生效;放错位置等于没写
特殊场景:同一后缀要按路径区分语言模式
比如项目里既有前端 .config.js(想用 javascript),又有 Vite 的 vite.config.ts(想用 typescript),但后缀都是 .config.js —— 单靠后缀无法区分。
- VSCode 本身不支持“按路径 + 后缀”复合匹配,
files.associations只认后缀或简单 glob - 可行方案是用
files.languageAssociations(VSCode 1.86+),但它仍只支持后缀,不支持路径 - 真正能解决的只有插件:比如
Auto Language Mode可基于文件路径、内容正则、甚至 package.json 字段来动态切换语言模式 - 临时办法:右键文件 →
Reopen with Language Mode→ 选对语言,然后勾选Configure File Association for '.config.js'...,它会把这次选择记进当前工作区的settings.json,但仅限该文件名,不是通配
语言模式关联看着简单,实际依赖配置层级、扩展行为、VSCode 版本三者咬合。最容易漏掉的是:改了 settings.json 没重启文件,或以为扩展开了就自动管所有后缀——其实它连 .env.production 都可能不管,除非你明确告诉它。










