🔍

首页 › 使用教程 › 开发与效率

.env 环境变量文件教程:语法规则、引号和注释、export 前缀,以及和 JSON 互转

发布于 · 阅读约 2 分钟 · 用到的工具:.env 与 JSON 互转

一句话答案

.env 文件每行一个 KEY=value,# 开头是注释,含空格的值用引号括起来,可以带 export 前缀。转成 JSON 时所有值都是字符串,例如 DB_PORT=5432 会变成 "5432"。含密钥的 .env 文件不要提交到代码仓库。

本文目录
  1. 基本语法
  2. .env 转 JSON
  3. JSON 转 .env
  4. 安全提醒
  5. 常见问题

.env 文件用来保存程序的环境变量配置,例如数据库地址、端口和功能开关,很多框架和工具会在启动时自动读取。

基本语法

写法说明
KEY=value每行一个变量,等号两边一般不加空格
# 注释井号开头的整行是注释
APP_NAME="My App"值里有空格时用引号括起来
export DB_HOST=localhost可以带 export 前缀,方便在 shell 里 source
EMPTY=值为空字符串

变量名习惯用大写字母、数字和下划线。不同的读取库对多行值、变量引用(例如 ${HOME})的支持不完全相同,以项目实际使用的库为准。

.env 转 JSON

  1. 粘贴内容:打开 .env 与 JSON 互转,把 .env 内容粘贴到上方输入框。
  2. 选择方向:下拉框选“.env → JSON”。
  3. 看结果:下方实时生成 JSON,注释被忽略,export 前缀和引号自动去掉。
  4. 复制:点“复制结果”。
带注释和 export 的 .env 转成 JSON
带注释和 export 的 .env 转成 JSON

示例:

  • # 数据库配置 → 忽略;
  • export DB_HOST=localhost → "DB_HOST": "localhost";
  • DB_PORT=5432 → "DB_PORT": "5432";
  • APP_NAME="My App" → "APP_NAME": "My App";
  • DEBUG=false → "DEBUG": "false"。

注意所有值都是字符串,环境变量本身没有数字和布尔类型,程序里需要自己转换。

JSON 转 .env

把下拉框切换到“JSON → .env”,粘贴一个扁平的 JSON 对象,就能生成 KEY=value 格式的 .env 内容,含空格等特殊字符的值会自动加引号。

⚙️ .env 与 JSON 互转
免费在线使用,文件和数据只在你的浏览器本地处理,无需注册。
打开工具 →

安全提醒

  1. 不要提交到代码仓库:把 .env 加入 .gitignore,另外提供一份不含真实密钥的 .env.example;
  2. 不要发到聊天群:密钥泄露后要尽快在对应平台作废并重新生成;
  3. 本地处理:这个工具在浏览器本地转换,不会上传内容。

其他配置格式的转换见 YAML 与 JSON 互转,JSON 检查见 JSON 格式化。

常见问题

.env 文件的值要加引号吗?

一般不用,值里有空格、# 等特殊字符时用引号括起来。

为什么转成 JSON 后数字变成了字符串?

环境变量的值本来就是字符串,没有数字和布尔类型,程序读取后需要自己转换。

export 前缀会怎么处理?

转换时自动去掉,只保留变量名和值。

内容会上传吗?

不会,转换完全在浏览器本地进行。