JSON 转 .env 转换器

什么是 .env 文件？

// Generate .env lines from a JSON object in Node.js
const config = {
  DATABASE_URL: 'postgres://user:pass@localhost:5432/mydb',
  PORT: 8080,
  DEBUG: true,
  NOTE: 'value with spaces',
};

const needsQuotes = (s) => /[\s#"'\n]/.test(s);

const env = Object.entries(config)
  .map(([key, value]) => {
    if (typeof value === 'string') {
      return needsQuotes(value)
        ? `${key}=${JSON.stringify(value)}`
        : `${key}=${value}`;
    }
    return `${key}=${value ?? ''}`; // null -> empty value
  })
  .join('\n');

console.log(env);
// DATABASE_URL=postgres://user:pass@localhost:5432/mydb
// PORT=8080
// DEBUG=true
// NOTE="value with spaces"

核心功能

示例

{
  "DATABASE_URL": "postgres://user:pass@localhost:5432/mydb",
  "PORT": 8080,
  "DEBUG": true,
  "LOG_LEVEL": "info",
  "API_KEY": "sk_live_abc123"
}

DATABASE_URL=postgres://user:pass@localhost:5432/mydb
PORT=8080
DEBUG=true
LOG_LEVEL=info
API_KEY=sk_live_abc123

{
  "GREETING": "Hello, World",
  "MOTD": "line one\nline two",
  "COLOR": "#ff0000",
  "NOTE": "value with # hash",
  "EMPTY": null
}

GREETING="Hello, World"
MOTD="line one\nline two"
COLOR="#ff0000"
NOTE="value with # hash"
EMPTY=

{
  "databaseUrl": "postgres://localhost/mydb",
  "poolSize": 10,
  "enable-signup": true
}

DATABASE_URL=postgres://localhost/mydb
POOL_SIZE=10
ENABLE_SIGNUP=true

{
  "APP_NAME": "my-app",
  "FEATURES": { "signup": true, "beta": false },
  "REGIONS": ["us-east-1", "eu-west-1"]
}

APP_NAME=my-app
FEATURES="{\"signup\":true,\"beta\":false}"
REGIONS="[\"us-east-1\",\"eu-west-1\"]"

使用方法

1. 1

   粘贴你的 JSON 对象

   在上方输入框中输入或粘贴一个扁平的 JSON 对象。你也可以点击「加载示例」来试用配置对象、需要加引号的值或嵌套对象。

2. 2

   查看实时 .env 输出

   .env 文件会立即出现在输出面板中。切换「规范化键」以获得 UPPER_SNAKE_CASE 名字，或在文件将被 shell source 时切换「添加 export 前缀」。

3. 3

   复制或下载

   点击「复制」把 .env 复制到剪贴板，或点击「下载」保存为 .env 文件 — 可直接放入你的项目并用 dotenv 加载。

常见 JSON 陷阱

["a", "b", "c"]

{"ITEMS": "a,b,c"}

{'PORT': 8080,}

{"PORT": 8080}

{"DB": {"host": "localhost", "port": 5432}}

{"DB_HOST": "localhost", "DB_PORT": 5432}

{"2fa-enabled": true}

{"TWO_FA_ENABLED": true}

{"MSG": Hello World}

{"MSG": "Hello World"}

常见使用场景

从配置导出生成 .env

拿一份来自 API、设置面板或密钥管理器的 JSON 配置导出，把它变成一个可直接使用的 .env 文件，用于本地开发或容器。

搭建 .env 模板

构建一个描述新服务所需变量的 JSON 对象，把它转成 .env，并提交一个 .env.example，让队友清楚知道要填哪些键。

把 JSON 配置的工具桥接到 dotenv

一些工具以 JSON 输出配置，而你的运行时期望一个 .env。把 JSON 输出转成 dotenv 格式，使管道的两端就同一组变量达成一致。

生成可被 source 的 shell env 文件

启用 export 前缀以生成一个可在 shell 或 CI 步骤中直接 source 的文件，一次粘贴就把一个 JSON 配置块变成导出的环境变量。

往返配置

把它与 .env 转 JSON 转换器配对，以结构化 JSON 编辑配置并写回 .env — 往返安全的加引号保证值在双向中都能存活。

规范化大小写混杂的键

用「规范化键」选项把一个带 camelCase 或 kebab-case 键的 JSON 对象转成带一致 UPPER_SNAKE_CASE 变量名的 .env，匹配环境变量约定。

技术细节

仅对象输入与按类型序列化

输入用浏览器原生的 JSON.parse() 解析，且必须是一个顶层对象；数组和标量会被以清晰的错误拒绝。每个顶层属性按类型序列化：数字和布尔值裸写，null 变成空值（KEY=），字符串直接写出，除非它包含空格、换行、# 或引号，此时会被加双引号并转义以保证往返安全。

嵌套值与键规范化

嵌套对象和数组用紧凑的 JSON.stringify 序列化、加双引号并转义，并有一条警告指明被扁平化的键。可选的「规范化键」步骤把键转换为 UPPER_SNAKE_CASE，解决大多数无效名字；当按原样保留键时，任何不匹配 [A-Za-z_][A-Za-z0-9_]* 的键会触发无效名字警告。可以为每行添加一个可选的 export 前缀。

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

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

最佳实践

除非需要 env 约定，否则按原样保留键

当消费应用已经期望你 JSON 中确切的键名时，让「规范化键」保持关闭，使任何键都不会被意外重命名。只有当你明确想要环境变量惯用的 UPPER_SNAKE_CASE 约定时才打开它。

有意地扁平化嵌套，而非意外地

嵌套值在 .env 中变成一个不透明的 JSON 字符串，多数应用无法自动解析回来。当你看到扁平化警告时，最好在转换前把 JSON 重整为扁平、带前缀的键（DB_HOST、DB_PORT），或选择像 YAML 这样的结构化格式。

信任自动加引号以实现往返

让工具来决定何时加引号 — 它只对需要的值加双引号并转义。这让 .env 保持可读，同时保证含空格、换行或 # 的值能原样经过 .env 转 JSON 转换器往返。

只在仅浏览器的工具中生成密钥

你在这里转换的 JSON 实际上是一组凭据。只在完全运行于浏览器中的工具里生成 .env；在 DevTools 中验证零网络请求。这个转换器符合条件，不像服务端或 API 后端的生成器。

先校验 JSON 输入

如果 JSON 是手写的或由脚本组装的，先用 JSON 格式化 校验它，以捕获尾随逗号或未加引号的键，这样你得到的是一个干净的 .env 而非令人困惑的解析错误。

常见问题