.env 转 JSON 转换器

什么是 .env 文件？

// Parse a .env file to a JSON object in Node.js using dotenv
import { parse } from 'dotenv';

const envText = `# Database
DATABASE_URL=postgres://user:pass@localhost:5432/mydb
DEBUG=true`;

// dotenv.parse returns a plain object of string values
const parsed = parse(envText);

// Every value is a string, just like process.env
const json = JSON.stringify(parsed, null, 2);

console.log(json);
// {
//   "DATABASE_URL": "postgres://user:pass@localhost:5432/mydb",
//   "DEBUG": "true"
// }

核心功能

示例

# Database
DATABASE_URL=postgres://user:pass@localhost:5432/mydb
DATABASE_POOL_SIZE=10

# Auth
JWT_SECRET="super secret value"
SESSION_TIMEOUT=3600

# Feature flags
ENABLE_SIGNUP=true
VITE_API_BASE=https://api.example.com

{
  "DATABASE_URL": "postgres://user:pass@localhost:5432/mydb",
  "DATABASE_POOL_SIZE": "10",
  "JWT_SECRET": "super secret value",
  "SESSION_TIMEOUT": "3600",
  "ENABLE_SIGNUP": "true",
  "VITE_API_BASE": "https://api.example.com"
}

POSTGRES_DB=mydb
POSTGRES_USER=admin
POSTGRES_PASSWORD=s3cr3t!
PGDATA=/var/lib/postgresql/data
TZ=UTC
NGINX_HOST=example.com
NGINX_PORT=80

{
  "POSTGRES_DB": "mydb",
  "POSTGRES_USER": "admin",
  "POSTGRES_PASSWORD": "s3cr3t!",
  "PGDATA": "/var/lib/postgresql/data",
  "TZ": "UTC",
  "NGINX_HOST": "example.com",
  "NGINX_PORT": "80"
}

export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export AWS_REGION=us-east-1
export DEPLOY_ENV=production

{
  "AWS_ACCESS_KEY_ID": "AKIAIOSFODNN7EXAMPLE",
  "AWS_SECRET_ACCESS_KEY": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
  "AWS_REGION": "us-east-1",
  "DEPLOY_ENV": "production"
}

APP_NAME=My App                 # unquoted value, inline comment stripped
GREETING="Hello,\nWorld"        # double quotes: \n becomes a real newline
LITERAL='no \n escapes here'    # single quotes: kept literally
PRIVATE_KEY="-----BEGIN KEY-----
line two
line three
-----END KEY-----"
EMPTY=

{
  "APP_NAME": "My App",
  "GREETING": "Hello,\nWorld",
  "LITERAL": "no \\n escapes here",
  "PRIVATE_KEY": "-----BEGIN KEY-----\nline two\nline three\n-----END KEY-----",
  "EMPTY": ""
}

使用方法

1. 1

   粘贴你的 .env 文件

   在上方输入框中输入或粘贴你的 .env 内容。你也可以点击「加载示例」来试用 Node/Vite .env、Docker Compose env 文件或 CI 密钥模板。

2. 2

   查看实时 JSON 输出

   JSON 会立即出现在输出面板中。如果你想要数字和布尔值而非字符串，切换「推断类型」，并选择 2 或 4 空格缩进。

3. 3

   复制或下载

   点击「复制」把 JSON 复制到剪贴板，或点击「下载」保存为 .json 文件 — 可直接用于配置加载器、密钥管理器或任何读取 JSON 的工具。

常见 .env 陷阱

DATABASE_URL
DEBUG true

DATABASE_URL=
DEBUG=true

API_KEY = abc123

API_KEY=abc123

COLOR=#ff0000

COLOR="#ff0000"

GREETING='Hello\nWorld'

GREETING="Hello\nWorld"

KEY="-----BEGIN-----
line two

KEY="-----BEGIN-----
line two
-----END-----"

PORT=3000
PORT=8080

PORT=8080

常见使用场景

把配置喂进基于 JSON 的工具

把 .env 文件转成 JSON，将环境配置加载进读取 JSON 而非环境变量的工具、脚本和 SDK — 配置校验器、Schema 检查器和代码生成器。

把密钥导入管理器

许多密钥管理器（AWS Secrets Manager、Vault、Doppler）接受 JSON 进行批量导入。先把 .env 文件转成 JSON 对象，再一次性推送整组，而非逐个变量。

一目了然地查看长 .env

把一个庞杂的 .env 文件变成结构化、带缩进的 JSON，让你能扫视键、通过警告发现重复，并在提交更改前以可读格式审阅配置。

生成带类型的配置对象

启用「推断类型」以在 JSON 中获得数字、布尔值和 null，然后把它喂进带类型的配置层或一个 JSON 转 TypeScript 步骤，为你的环境变量推导出一个接口。

用 JSON Schema 校验

把 .env 转成 JSON 并通过 JSON Schema 校验器运行，在 CI 中强制必填键、值格式和允许的枚举 — 在部署前捕获配置错误的环境。

迁移 Docker Compose 的 env_file 配置

把 Compose 栈读取的 env_file 转成 JSON，用于另一个编排工具、配置服务器或文档 — 而不会把真实凭据暴露给任何外部服务。

技术细节

逐行的 dotenv 兼容解析

输入被逐行解析。空行和注释行（第一个非空白字符为 #）被跳过，可选的 export 前缀被移除，每个剩余行在第一个 = 处拆分为键和值。键会去除两侧空白。值遵循 dotenv 规则：双引号处理 \n \t \r \\ \" 转义并允许多行跨越，单引号是字面的，未加引号的值去除尾部空白和行内注释。

可选的类型推断

默认情况下所有值都作为 JSON 字符串输出，匹配 dotenv 的运行时行为 — 其中 process.env 的值始终是字符串。启用「推断类型」后，未加引号的值会被提升：数字字符串变成 JSON 数字，true/false 变成布尔值，空值或 null 变成 JSON null。加引号的值绝不会被推断 — 引号将它们标记为明确的字符串。重复键以「最后取胜」解析并附警告。

基于浏览器 — 无上传、无服务器

所有处理都完全在你浏览器的 JavaScript 引擎中进行；任何时候都不会有 .env 数据通过网络传输。没有外部依赖，因为解析器是自研的 — Node 的 dotenv 库依赖文件系统，对浏览器不安全。超过 200KB 的输入会从实时模式切换到手动模式（明确点击「转换」）以保持浏览器响应流畅。

最佳实践

保留默认字符串输出以匹配 dotenv

dotenv 把每个值都作为字符串加载，所以默认的字符串输出恰好反映你的应用在运行时所见。只有当下游消费者确实期望带类型的 JSON 时才启用「推断类型」 — 否则你会面临一种不匹配：'0' 或 'false' 在 JSON 中的行为与运行中的应用不同。

为含 # 或空白的值加引号

在未加引号的值上，一个空格后跟 # 会开始行内注释，且尾部空白会被去除。如果一个值确实包含 #（十六进制颜色、片段 URL）或有意义的空格，请用双引号包裹，使其在 JSON 中被原样保留。

在源头解决重复键

工具会保留最后的值并在键重复时警告你，但 .env 文件中的重复几乎总是错误。移除多余的行，使哪个密钥生效不再含糊。

绝不要把生产密钥粘贴到服务端转换器

由于 .env 文件实际上是一份凭据清单，只在完全运行于浏览器中的工具里转换它。这个转换器就是如此 — 在 DevTools 中验证零网络请求 — 所以它对真实密钥是安全的，不像服务端或 API 后端的转换器。

在下游使用前校验 JSON

转换之后，先用 JSON 格式化 运行 JSON 以确认结构，再把它喂进 Schema 校验器、密钥管理器导入或配置加载器，使结构上的意外尽早浮现。

常见问题