VSCode 中需安装 DotENV 插件并手动关联 .env 语言模式,再配置 files.associations 和 editor.suggest 相关设置,方可实现语法高亮、注释识别及变量补全。

如果您在使用 VSCode 编辑 .env 文件时发现没有语法高亮、变量名无法识别、自动补全缺失,则可能是 DotENV 插件未正确启用或配置。以下是实现 .env 文件语法高亮与变量补全的具体操作步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装并启用 dotenv 官方推荐插件
VSCode 市场中存在多个支持 .env 文件的扩展,但官方推荐且维护活跃的是由 mikestead 提供的 “DotENV” 插件,它原生支持语法高亮、注释识别及基础变量提示。
1、打开 VSCode,点击左侧活动栏的扩展图标(或按快捷键 Ctrl+Shift+X / Cmd+Shift+X)。
2、在搜索框中输入 dotenv,找到名称为 “DotENV” 的插件(作者:mikestead,图标为绿色圆点内含 “.env” 字样)。
3、点击“安装”按钮,安装完成后点击“重新加载”使插件生效。
4、新建或打开任意以 .env 为扩展名的文件,观察是否出现黄色关键字(如 export)、灰色注释及等号两侧的浅蓝/浅灰颜色区分。
二、手动关联 .env 文件类型
某些项目中 .env 文件可能被 VSCode 误识别为纯文本,导致插件功能不触发;需强制将 .env 关联至 dotenv 语言模式,以激活语法解析引擎。
1、打开一个 .env 文件。
2、点击右下角显示的语言模式(通常为 “Plain Text”),弹出语言选择面板。
3、在搜索框中输入 dotenv,从列表中选择该项。
4、勾选 “Configure File Association for '.env'”,确认后所有同名文件将默认使用该语言模式。
三、启用变量跨文件补全(需配合 dotenv-flow 或 dotenv-expand)
原生 DotENV 插件不提供变量定义跳转或跨文件引用补全;若项目使用多层级 .env 文件(如 .env.local、.env.development),需借助其他插件协同实现变量感知能力。
1、在扩展市场中搜索并安装 dotenv-flow 插件(作者:mikestead)。
2、确保项目根目录存在 .env 及对应环境变体文件(如 .env.development)。
3、在 VSCode 设置中搜索 files.associations,点击“在 settings.json 中编辑”。
4、添加如下配置项:".env*": "dotenv",保存后重启编辑器。
四、配置 IntelliSense 补全触发条件
VSCode 默认不会对 .env 文件主动触发变量建议,需显式开启编辑器内联补全支持,并调整触发策略。
1、打开命令面板(Ctrl+Shift+P / Cmd+Shift+P),输入 Preferences: Open Settings (JSON) 并回车。
2、在 settings.json 中插入以下字段:
"editor.suggest.showVariables": true,
"editor.quickSuggestions": {"strings": true},
"editor.suggest.snippetsPreventQuickSuggestions": false
3、保存文件,重新打开 .env 文件,在等号右侧输入 $ 符号,观察是否弹出已声明变量名列表。










