Конвертер 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 или «Добавить префикс export», если файл будет подключаться в shell.

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 из экспорта конфигурации

Возьмите экспорт конфигурации JSON из API, панели настроек или менеджера секретов и превратите его в готовый к использованию файл .env для локальной разработки или контейнера.

Создание шаблонов .env

Постройте объект JSON, описывающий переменные, нужные новому сервису, преобразуйте его в .env и зафиксируйте .env.example, чтобы коллеги точно знали, какие ключи заполнить.

Связь инструментов на JSON с dotenv

Некоторые инструменты выдают конфигурацию как JSON, тогда как ваш рантайм ожидает .env. Преобразуйте вывод JSON в формат dotenv, чтобы обе половины конвейера согласовались на одних и тех же переменных.

Создание подключаемых shell-файлов env

Включите префикс export, чтобы сгенерировать файл, который можно подключить напрямую в shell или шаге CI, превратив блоб JSON-конфигурации в экспортированные переменные окружения за одну вставку.

Полный цикл конфигурации

Сочетайте это с конвертером .env в JSON, чтобы редактировать конфигурацию как структурированный JSON и записывать её обратно в .env — закавычивание, безопасное для полного цикла, гарантирует, что значения переживут оба направления.

Нормализация ключей со смешанным регистром

Преобразуйте объект JSON с ключами в camelCase или kebab-case в .env с единообразными именами переменных в UPPER_SNAKE_CASE с помощью опции «Нормализовать ключи», в соответствии с соглашениями о переменных окружения.

Технические детали

Только объект на входе с типизированной сериализацией

Ввод разбирается нативным JSON.parse() браузера и должен быть объектом верхнего уровня; массивы и скаляры отклоняются с понятной ошибкой. Каждое свойство верхнего уровня сериализуется по типу: числа и логические значения пишутся голыми, null становится пустым значением (KEY=), а строки пишутся напрямую, если только не содержат пробел, перевод строки, # или кавычку, — в этом случае они заключаются в двойные кавычки и экранируются ради безопасности полного цикла.

Вложенные значения и нормализация ключей

Вложенные объекты и массивы сериализуются компактным JSON.stringify, заключаются в двойные кавычки и экранируются, с предупреждением, называющим развёрнутые ключи. Необязательный шаг «Нормализовать ключи» преобразует ключи в UPPER_SNAKE_CASE, разрешая большинство недопустимых имён; при сохранении ключей дословно любой ключ, не соответствующий [A-Za-z_][A-Za-z0-9_]*, вызывает предупреждение о недопустимом имени. К каждой строке можно добавить необязательный префикс export.

На стороне браузера — без загрузки, без сервера

Вся обработка происходит целиком в движке JavaScript вашего браузера; данные JSON ни в какой момент не передаются по сети. Сериализатор написан внутри проекта без внешних зависимостей, поскольку библиотека Node dotenv небезопасна для браузера. Ввод размером более 200 КБ переключается из живого режима в ручной (явное нажатие «Преобразовать»), чтобы сохранить отзывчивость браузера.

Лучшие практики

Сохраняйте ключи дословно, если не нужны соглашения env

Оставьте «Нормализовать ключи» выключенной, когда потребляющее приложение уже ожидает точные имена ключей из вашего JSON, чтобы ничего не было неожиданно переименовано. Включайте её только тогда, когда вам конкретно нужно соглашение UPPER_SNAKE_CASE, которое по соглашению используют переменные окружения.

Разворачивайте вложенность намеренно, а не случайно

Вложенное значение становится непрозрачной строкой JSON в .env, которую большинство приложений не могут разобрать обратно автоматически. Когда видите предупреждение о развёртывании, лучше переформируйте JSON в плоские ключи с префиксами (DB_HOST, DB_PORT) перед преобразованием либо выберите структурированный формат вроде YAML.

Доверяйте автоматическому закавычиванию для полного цикла

Позвольте инструменту решать, когда заключать в кавычки — он заключает в двойные кавычки и экранирует только те значения, которым это нужно. Это сохраняет .env читаемым, гарантируя, что значения с пробелами, переводами строк или # переживут полный цикл обратно через конвертер .env в JSON без изменений.

Генерируйте секреты только в инструменте на стороне браузера

JSON, который вы здесь преобразуете, фактически является набором учётных данных. Генерируйте .env только в инструменте, работающем целиком в браузере; проверьте отсутствие сетевых запросов в DevTools. Этот конвертер соответствует требованиям, в отличие от серверных или API-генераторов.

Сначала проверьте ввод JSON

Если JSON написан вручную или собран скриптом, сначала проверьте его с помощью форматировщика JSON, чтобы поймать завершающие запятые или ключи без кавычек, и получить чистый .env вместо запутанной ошибки разбора.

Часто задаваемые вопросы