.env 环境变量文件教程:语法规则、引号和注释、export 前缀,以及和 JSON 互转
一句话答案
.env 文件每行一个 KEY=value,# 开头是注释,含空格的值用引号括起来,可以带 export 前缀。转成 JSON 时所有值都是字符串,例如 DB_PORT=5432 会变成 "5432"。含密钥的 .env 文件不要提交到代码仓库。
.env 文件用来保存程序的环境变量配置,例如数据库地址、端口和功能开关,很多框架和工具会在启动时自动读取。
基本语法
| 写法 | 说明 |
|---|---|
KEY=value | 每行一个变量,等号两边一般不加空格 |
# 注释 | 井号开头的整行是注释 |
APP_NAME="My App" | 值里有空格时用引号括起来 |
export DB_HOST=localhost | 可以带 export 前缀,方便在 shell 里 source |
EMPTY= | 值为空字符串 |
变量名习惯用大写字母、数字和下划线。不同的读取库对多行值、变量引用(例如 ${HOME})的支持不完全相同,以项目实际使用的库为准。
.env 转 JSON
- 粘贴内容:打开 .env 与 JSON 互转,把 .env 内容粘贴到上方输入框。
- 选择方向:下拉框选“.env → JSON”。
- 看结果:下方实时生成 JSON,注释被忽略,export 前缀和引号自动去掉。
- 复制:点“复制结果”。

示例:
# 数据库配置→ 忽略;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 互转
免费在线使用,文件和数据只在你的浏览器本地处理,无需注册。
安全提醒
- 不要提交到代码仓库:把 .env 加入
.gitignore,另外提供一份不含真实密钥的.env.example; - 不要发到聊天群:密钥泄露后要尽快在对应平台作废并重新生成;
- 本地处理:这个工具在浏览器本地转换,不会上传内容。
其他配置格式的转换见 YAML 与 JSON 互转,JSON 检查见 JSON 格式化。
常见问题
.env 文件的值要加引号吗?
一般不用,值里有空格、# 等特殊字符时用引号括起来。
为什么转成 JSON 后数字变成了字符串?
环境变量的值本来就是字符串,没有数字和布尔类型,程序读取后需要自己转换。
export 前缀会怎么处理?
转换时自动去掉,只保留变量名和值。
内容会上传吗?
不会,转换完全在浏览器本地进行。