更新记录

1.0.0（2026-10-28）下载此版本

为 .env / .env.local 等环境变量文件提供语法高亮，无运行时依赖

平台兼容性

HbuilderX/cli最低兼容版本
3.6.11

DotENV 语法高亮

为 .env 系列文件提供语法高亮。纯声明式插件，无 extension.js、无运行时依赖、不修改任何项目文件，装上就生效。

dotenv 是跨语言的通用约定 —— Node.js、Python、Go、Rust、Ruby、PHP、Docker Compose 用的都是同一套 .env 格式，因此本插件不限定项目类型，任何项目里的 .env 文件都适用。

解决的痛点

HBuilderX 原生不支持 dotenv 格式，打开 .env 只是一片灰白纯文本：键名和值分不清，# 注释不上色，Ctrl+/ 注释会插 // 把文件写坏。

特性

元素	效果
键名 `APP_NAME`	标签色
`=`	运算符色
`export` 前缀	关键字色
双引号 / 单引号 / 反引号字符串	字符串色
`${VAR}`、`$VAR` 变量插值	变量色
反斜杠转义 `\"` `\n`	转义色
`true` / `false` / `null`	常量色
数字	数值色
`#` 整行注释、行尾注释	注释色

此外：Ctrl+/ 按 # 注释当前行（而不是 //），括号自动闭合与匹配。

支持的文件名

.env、.env.local、.env.development、.env.production、.env.test、.env.staging、.env.example、.env.sample、.env.template 等常见命名。

注意： HBuilderX 的语言匹配只取文件名的最后一段扩展名（.env.production 的扩展名是 .production）。因此若你的项目使用了上表之外的后缀（如 .env.preview），需要在插件 plugins/dotenv-language/package.json 的 contributes.languages[0].extensions 数组里补一条 .preview，重启 HBuilderX 后生效。

高亮效果示例

# ===== 应用配置 =====
export APP_ENV=production
APP_NAME="My Application"
DEBUG=false
WORKER_COUNT=4

# 双引号内支持插值
API_URL="${API_BASE}/users?token=$ACCESS_TOKEN"

# 单引号内不解析插值
RAW_PATH='/data/${NOT_INTERPOLATED}/logs'

# 行尾注释
TIMEOUT=30000 # 单位毫秒

安装

方式一（推荐）：插件市场一键安装。

方式二（离线）：下载 zip 解压到 HBuilderX/plugins/dotenv-language/，完全退出 HBuilderX 后重新启动。

兼容性

HBuilderX 3.6.11 及以上（在 5.33.2026102401 实测通过）
不限项目类型：uni-app、uni-app x、Node.js、Python、Go、Rust、Docker Compose 等均可

已知限制

HBuilderX 的语法引擎不支持 VS Code 的 filenamePatterns / filenames 字段（主程序内 filenamePatterns 字符串出现次数为 0），因此多段文件名只能通过列举 extensions 实现，这是 HBuilderX 侧的限制而非本插件的问题。

许可

MIT