Парсер файла .env — Проверка и форматирование

Что такое парсер файлов .env?

.env File Parser & Formatter — это инструмент на основе браузера для работы с файлами переменных среды. Он анализирует содержимое KEY=VALUE для обнаружения синтаксических ошибок, выявления дублирующихся ключей и отображения статистики файла; преобразует ваши переменные в JSON, YAML, Docker --env-file или формат docker-compose.yml одним кликом; и объединяет два файла .env с интерактивным разрешением конфликтов, когда один и тот же ключ встречается в обоих файлах с разными значениями.

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

Основные возможности

• Разбор пар KEY=VALUE с поддержкой значений в кавычках и многострочных значений — значения в одинарных и двойных кавычках автоматически убираются из кавычек; встроенные комментарии после значений без кавычек удаляются.
• Обнаружение дублирующихся ключей с предупреждающими значками — каждый ключ, встречающийся более одного раза, отмечается в панели Validation жёлтым значком предупреждения.
• Проверка синтаксиса: отсутствующий =, пустые ключи, недопустимые символы — парсер требует, чтобы ключи начинались с буквы или символа подчёркивания и содержали только буквенно-цифровые символы и символы подчёркивания (/^[a-zA-Z_][a-zA-Z0-9_]*$/). Каждое нарушение сообщает конкретный номер строки.
• Сортировка переменных по алфавиту — кнопка Sort перезаписывает входную текстовую область переменными в порядке возрастания лексикографического порядка, заменяя исходное содержимое.
• Преобразование в формат JSON — создаёт красиво отформатированный JSON-объект со всеми ключами и значениями переменных.
• Преобразование в формат YAML — автоматически заключает значения в двойные кавычки, когда значение содержит специальные символы YAML (:, #, {, }, [, ], ,, &, *, !, |, >, ', ", %, @, ` `), строки, похожие на булевы (true, false, yes, no, null`), чисто числовые строки или пустые значения.
• Преобразование в формат Docker --env-file — выводит «голые» пары KEY=VALUE без кавычек, как требует docker run --env-file.
• Преобразование в блок среды docker-compose.yml — оборачивает вывод в блок YAML environment: с элементами списка (- KEY=VALUE), готовый для вставки в определение сервиса docker-compose.yml.
• Слияние двух файлов .env с обнаружением и разрешением конфликтов — параллельные текстовые поля; конфликты перечисляются с обоими значениями, чтобы вы могли выбрать победителя перед применением.
• Отображение статистики: количество переменных, комментарии, пустые строки — после разбора отображаются четыре счётчика: Variables, Comments, Empty Lines и Duplicates.
• Поддержка загрузки файлов — загружайте файлы .env, .env.* или .txt прямо с диска.
• 100% обработка на стороне клиента — ваши секреты никогда не покидают ваш браузер.

Как использовать парсер файлов .env

Шаг 1: Ввод или загрузка содержимого .env

Переключайтесь между двумя режимами с помощью вкладок Parse & Validate и Merge в верхней части инструмента.

В режиме Parse вставьте содержимое .env непосредственно в левое текстовое поле или нажмите Upload, чтобы загрузить файл с диска (принимает файлы .env, .env.* и .txt). Если вы хотите исследовать поведение инструмента без собственных данных, нажмите Load Example, чтобы заполнить ввод демонстрационным файлом, включающим комментарии, значения в кавычках, дублирующийся ключ и намеренно некорректную строку.

Пример ввода:

# Application Configuration
APP_NAME=my-awesome-app
APP_ENV=production
APP_PORT=3000

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

# Duplicate key (triggers warning)
APP_PORT=8080

# Invalid line (triggers error)
MISSING_EQUALS

Шаг 2: Проверка статистики и панели Validation

После ввода или вставки содержимого под редактором появляются две панели:

Statistics отображает четыре счётчика в сетке:

• Variables — количество допустимых записей KEY=VALUE
• Comments — строки, начинающиеся с #
• Empty Lines — пустые строки
• Duplicates — ключи, встречающиеся более одного раза (счётчик становится жёлтым, когда не равен нулю)

Validation перечисляет каждую обнаруженную проблему:

• Дублирующиеся ключи отображаются с жёлтым значком треугольника: "Duplicate key: APP_PORT"
• Синтаксические ошибки отображаются с красным значком X с указанием точной строки: "Line 14: Missing '=' sign"
• Если проблем нет, зелёная галочка подтверждает: "No issues found"

Шаг 3: Выбор формата вывода

Селектор формата правой панели предлагает пять вариантов:

Нажмите любую кнопку, чтобы мгновенно переключить вывод. Все форматы исключают строки комментариев и пустые строки — включаются только допустимые записи переменных.

Формат вывода .env также нормализует кавычки: значения, содержащие пробелы, # или ", автоматически заключаются в двойные кавычки с экранированием внутренних двойных кавычек.

Шаг 4: Сортировка и копирование

Нажмите Sort, чтобы перезаписать входное текстовое поле с переменными в алфавитном порядке. Это изменяет ввод на месте, поэтому отсортированное содержимое становится новым источником для разбора и вывода.

Нажмите Copy в заголовке панели вывода, чтобы скопировать отформатированный результат в буфер обмена.

Шаг 5: Слияние двух файлов .env (Опционально)

Переключитесь на вкладку Merge. Вставьте или загрузите один файл .env в текстовое поле File A и другой в File B, затем нажмите Merge Files.

• Если два файла не имеют конфликтующих ключей (одинаковый ключ с разными значениями), слияние завершается немедленно и результат появляется во вводе вкладки Parse для дальнейшего редактирования.
• Если конфликты существуют, панель Conflict Resolution перечисляет каждый конфликтующий ключ с обоими значениями в виде кнопок. Нажмите кнопку значения, которое хотите сохранить (A или B), затем нажмите Apply Merge, чтобы объединить файлы с использованием ваших выборов.

Практические примеры

Аудит Production .env перед деплоем

Вставьте производственный файл среды и посмотрите на панель Validation. Даже одна ошибка "Missing '=' sign" или предупреждение о дублирующемся ключе может указывать на ошибку копирования и вставки, которая приведёт к сбою конфигурации во время выполнения. Счётчики Statistics дают быстрое число для сверки со списком ожидаемых переменных.

Преобразование для Docker

У вас есть файл .env, который работает с dotenv в Node.js, но нужно передать его в Docker-контейнер. Выберите Docker --env-file для использования с docker run --env-file .env, или выберите docker-compose.yml, чтобы получить готовый блок environment::

environment:
  - APP_NAME=my-awesome-app
  - APP_ENV=production
  - DATABASE_POOL_SIZE=10

Вставьте блок прямо в определение вашего сервиса.

Слияние базовых и переопределяющих файлов

В вашем проекте есть .env.base с общими значениями по умолчанию и .env.local с переопределениями для конкретного разработчика. Загрузите .env.base в File A и .env.local в File B, нажмите Merge Files, разрешите конфликты, выбирая значение локального переопределения, затем скопируйте объединённый вывод как рабочий .env.

Советы и лучшие практики

Загружайте файлы вместо вставки длинных конфигураций. Кнопка загрузки файлов принимает форматы .env, .env.* и .txt. Это позволяет избежать ограничений размера буфера обмена и случайной порчи данных из-за пробелов в конце строки, которая может происходить при копировании из терминалов.

Сортируйте перед сравнением. Если вы вручную сравниваете два файла среды, сначала отсортируйте оба. Кнопка Sort нормализует порядок, чтобы ваш инструмент сравнения мог находить значимые изменения, а не шум от разных порядков переменных.

Вывод YAML автоматически заключает в кавычки значения, похожие на булевы. Форматировщик обнаруживает строки вроде true, false, yes, no и null и заключает их в двойные кавычки. Это не позволяет парсерам YAML интерпретировать FEATURE_FLAG=true как булево true, а не строку "true".

Формат вывода .env перекавычивает значения с пробелами. Если ваш ввод содержит SECRET_KEY=my secret with spaces, вывод .env отобразит это как SECRET_KEY="my secret with spaces". Это безопасно для копирования обратно в любой загрузчик, совместимый с dotenv.

Встроенные комментарии для значений без кавычек удаляются. Строка вроде APP_PORT=3000 # HTTP port разберёт значение как 3000, отбросив встроенный комментарий. Значения в кавычках, такие как DESCRIPTION="hello # world", сохраняют # как часть значения.

Распространённые проблемы и устранение неполадок

"Line N: Missing '=' sign" — Строка содержит текст, но не имеет знака равенства. Это наиболее распространённая ошибка при вставке операторов экспорта оболочки, таких как export APP_NAME=foo. Удалите ключевое слово export перед вставкой.

"Line N: Empty key" — Строка начинается с =, например =value. Парсеру требуется непустой ключ перед знаком равенства.

"Line N: Invalid key 'MY-KEY'" — Дефисы не допускаются в ключах переменных среды по стандарту POSIX, и этот парсер применяет ^[a-zA-Z_][a-zA-Z0-9_]*$. Замените дефисы символами подчёркивания: MY_KEY.

Предупреждение о дублирующемся ключе, но значения одинаковые — Парсер помечает все ключи, встречающиеся более одного раза, независимо от того, отличаются ли значения. Удалите избыточную строку из ввода.

Кнопка Merge неактивна — File A и File B должны оба содержать контент. Кнопка отключена, если одно из текстовых полей пустое.

В выводе YAML неожиданные кавычки — Значения, которые являются чисто числовыми или совпадают с булевыми литералами (true, false, yes, no, null), заключаются в кавычки для сохранения их строкового типа. Это намеренное и корректное поведение YAML.

Конфиденциальность и безопасность

.env File Parser работает полностью в вашем браузере без серверной обработки. Ваши переменные среды — включая API-ключи, учётные данные базы данных и секретные токены — никогда не передаются по сети. Логика разбора, проверки, преобразования форматов и слияния — всё это функции JavaScript, выполняющиеся локально. Инструмент работает в офлайн-режиме после начальной загрузки страницы. Сторонние аналитические скрипты не имеют доступа к содержимому текстовой области.

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

Парсер файлов .env бесплатный? Да, полностью бесплатный без необходимости создания аккаунта.

Безопасно ли вставлять реальные API-ключи и секреты? Да. Вся обработка происходит в вашем браузере с использованием локального JavaScript. Ничего не отправляется на какой-либо сервер. Ваши секреты остаются на вашей машине.

Можно ли использовать в офлайн-режиме? Да. После загрузки страницы разбор и преобразование работают без подключения к интернету.

Поддерживаются ли многострочные значения? Парсер обрабатывает однострочные значения в кавычках. Истинные многострочные значения, охватывающие несколько строк (с использованием продолжения обратной косой черты или синтаксиса heredoc), в настоящее время не поддерживаются. Разделите многострочное содержимое на одну строку в кавычках перед разбором.

Почему моё значение в кавычках всё ещё появляется в выводе без кавычек? Функция unquoteValue удаляет соответствующие одинарные или двойные кавычки, окружающие всё значение. DATABASE_URL="postgres://..." внутренне становится postgres://... и при необходимости заново заключается в кавычки в формате вывода. Это корректное поведение для преобразования форматов.

Что происходит со строками комментариев в выводе? Комментарии (строки, начинающиеся с #) исключены из всех форматов вывода. Включаются только допустимые записи переменных. Комментарии подсчитываются в панели Statistics, но не записываются в вывод.

Можно ли объединить более двух файлов? Инструмент поддерживает слияние ровно двух файлов за раз. Чтобы объединить три или более файлов, сначала объедините A+B, скопируйте результат в режим Parse, затем используйте его как File A для второго слияния с File C.

Сохраняет ли операция сортировки строки комментариев? Нет. Кнопка Sort использует только разобранные допустимые переменные для восстановления отсортированного ввода, отбрасывая строки комментариев и пустые строки. Используйте Sort, когда хотите получить чистый, нормализованный файл.

Что такое формат Docker --env-file? docker run --env-file ожидает «голые» строки KEY=VALUE без кавычек оболочки. Формат вывода Docker опускает кавычки даже для значений с пробелами, что правильно для формата Docker, но не работало бы в скрипте оболочки. Используйте формат .env, если вам нужны безопасные кавычки для оболочки.

Можно ли определить, какие переменные различаются между двумя файлами, не объединяя их? Переключитесь в режим Merge и нажмите Merge Files. Список конфликтов показывает каждый ключ, где File A и File B имеют разные значения, что служит практическим diff отличающихся переменных.

Похожие инструменты

• Config Generator — Создавайте структурированные файлы конфигурации для различных фреймворков и сред.
• Docker Converter — Конвертируйте между форматами конфигурации, связанными с Docker.
• YAML to TOML — Конвертируйте между форматами файлов конфигурации YAML и TOML.

Попробуйте .env File Parser прямо сейчас: .env File Parser & Formatter