DotENV插件装了但没高亮，根本原因是VSCode未识别为dotenv语言模式；需手动切换右下角语言为dotenv并勾选关联，再在settings.json中配置".env": "dotenv"和".env.*": "dotenv"以覆盖所有变体文件。
DotENV插件装了但没高亮？先确认语言模式是否生效
VSCode 不会自动把 .env 文件识别为 dotenv 语言，哪怕插件已安装。右下角显示 Plain Text 就是典型信号——插件根本没被触发。
手动切换语言模式最直接：打开任意 .env 文件 → 点击右下角 Plain Text → 输入 dotenv 并回车 → 勾选 Configure File Association for '.env'。
常见坑点：
-
.env.local、.env.development这类文件默认不被识别，必须额外配置 - 某些插件注册的语言 ID 是
environment或env，而非dotenv，可在Change Language Mode弹窗里核对真实 ID - 已打开的文件不会自动刷新语言模式，改完需重新打开
files.associations 怎么配才覆盖所有环境文件名
只配 ".env": "dotenv" 只能匹配根目录下的 .env，项目里常见的 .env.development、docker.env、.env.example 全部失效。
推荐在 settings.json 中加这两行（注意逗号和引号）：
"files.associations": {
"*.env*": "dotenv",
".env.*": "dotenv"
}
解释：
-
*.env*匹配docker.env、secrets.env.bak等含env的任意位置 -
.env.*匹配.env.development、.env.test等标准变体（VSCode glob 不支持**，必须拆开写） - 别用
*env*，它会误匹配package.json里的env字段，导致语法错乱
为什么变量补全不出现？原生 DotENV 不支持跨文件跳转
DotENV 插件（mikestead 版）只做语法高亮和基础内联提示，不解析变量引用关系，也不会从 .env.development 里读出 API_URL 并在 .env 里补全。
如果需要变量感知能力，得组合使用：
- 装
dotenv-flow插件（同作者），它能识别多层.env文件并合并上下文 - 确保项目根目录存在
.env和对应变体（如.env.development） - 配合
files.associations配置，否则dotenv-flow无法识别文件类型 - 补全仍仅限于当前文件内已定义的键，不会自动推导
${NODE_ENV}展开后的值
高亮正常但值显示错位或报错 Invalid character？检查 BOM 和不可见字符
UTF-8 with BOM 是最大元凶：Windows 记事本、某些 CI 工具生成的 .env 文件开头带 3 字节 BOM（EF BB BF），VSCode 解析时会把第一行当乱码，后续所有 = 对齐崩坏，高亮错位甚至报 Invalid character。
修复方法：
- 用 VSCode 打开文件 → 右下角点击编码格式（如
UTF-8）→ 选Save with Encoding→ 改为UTF-8（不含 BOM） - 用命令行快速检测：
head -c 3 .env | xxd，若输出含ef bb bf即存在 BOM - 同时检查行尾是否混用
CRLF和LF，尤其在 Git Windows 客户端开启core.autocrlf=true时易发
插件再强，也救不了编码污染的文件——这步漏掉，其他配置全白搭。
