Как пользоваться: Валидатор .env файлов
- Вставьте ваш
.envв левое поле. При желании вставьте.env.example(или список обязательных ключей) в правое поле. - Просмотрите список проблем: ошибки ломают разбор файла, предупреждения указывают на вероятные ошибки или рискованные значения.
- Проверьте таблицу по каждой переменной — значения скрыты, поэтому можно безопасно поделиться скриншотом.
- Скачайте сгенерированный
.env.exampleи добавьте его в репозиторий вместо вашего реального.env.
Синтаксис .env в двух словах
| Строка | Результат |
|---|---|
PORT=3000 | Простое значение |
APP_NAME="My App" | Кавычки нужны для пробелов |
GREETING='Hello $USER' | Одинарные кавычки: подстановка переменных не выполняется (dotenv-expand, Docker Compose) |
KEY="line1\nline2" | В двойных кавычках \n превращается в перенос строки |
export TOKEN=abc | Префикс export допустим и игнорируется dotenv |
# comment | Комментарий; после значения — только если перед ним пробел и значение без кавычек |
Частые ошибки, которые находит валидатор
- Дублирующиеся ключи — большинство загрузчиков молча оставляют первое или последнее значение, поэтому изменения кажутся бесполезными.
- Пробелы вокруг = или в значениях без кавычек —
KEY = valueломается в shell и Docker. - Незакрытые кавычки, которые «съедают» следующие строки.
- Некорректные имена — ключи должны состоять из букв, цифр и подчёркиваний и не начинаться с цифры.
- Секреты, такие как ключи AWS, боевые ключи Stripe, токены GitHub или приватные ключи — допустимы в локальном .env, но никогда не должны попадать в репозиторий.
Как не допустить попадания .env в Git
Добавьте .env в ваш .gitignore и коммитьте .env.example только с ключами. В CI храните значения как секреты — см. генератор GitHub Actions Workflow. Фронтенд-фреймворки передают в браузер переменные с префиксами вроде VITE_, NEXT_PUBLIC_ или PUBLIC_ — никогда не кладите туда секреты.
Также ищут как: dotenv validator, генератор env example, проверка переменных окружения, отсутствующие переменные окружения, синтаксис dotenv.
Инструменты, которые хорошо сочетаются с Валидатор .env файлов
- Генератор Docker Compose — Отметьте нужные сервисы — приложение, базу данных, кеш, панель администратора, перехватчик почты — и получите аккуратный compose.yaml с закреплёнными версиями образов, именованными томами, healthcheck и условиями depends_on, а также подходящий .env со сгенерированными паролями.
- Генератор package.json — Заполните форму и получите корректный package.json: проверка имени npm, готовые наборы скриптов для Vite, Next.js, Node и TypeScript-библиотек, exports, engines, лицензия и репозиторий.
- Инспектор Unicode-символов — Вставьте любой текст, чтобы увидеть, из чего он состоит на самом деле: имя, кодовую точку, UTF-8 байты и HTML-код каждого символа.
- Сравнение текстов — Вставьте исходную и изменённую версии, чтобы увидеть добавленные, удалённые и изменённые строки рядом — с подсветкой точно изменённых слов внутри каждой строки.
Часто задаваемые вопросы
Безопасно ли вставлять здесь мой .env?
Валидатор работает только в вашем браузере: ничего не загружается и не сохраняется. Значения в отчёте скрыты. Тем не менее, не вставляйте боевые секреты ни на какие сайты, если это запрещено вашей политикой безопасности — используйте файл примера.
Нужны ли кавычки в файле .env?
Только если значение содержит пробелы, #, кавычки или переносы строк либо начинается с специального символа. Двойные кавычки допускают экранирование, например \n; одинарные кавычки сохраняют значение буквально.
Для чего нужен .env.example?
Он документирует, какие переменные нужны проекту, без реальных значений. Добавьте его в репозиторий, чтобы новые участники команды и CI знали, что нужно настроить; сам же настоящий .env держите вне Git.
Почему моя переменная остаётся undefined?
Типичные причины: опечатка или другой регистр в ключе, дубль ниже по файлу, пробелы вокруг =, незакрытая кавычка выше по тексту или файл не загружается (неверная папка или не настроен dotenv). Фронтенд-сборщики также требуют префиксы вроде VITE_ или NEXT_PUBLIC_.
Можно ли установить Валидатор .env файлов как веб-приложение и пользоваться им офлайн?
Да. Валидатор .env файлов — это веб-приложение (PWA), которое можно установить из браузера, без скачивания из магазина приложений. В Chrome или Edge (Windows, macOS, Linux, ChromeOS) или на Android нажмите вверху этой страницы «Установить приложение»; на iPhone и iPad используйте «Поделиться → На экран «Домой»», а в Safari 17+ на Mac — «Файл → Добавить в Dock». После этого приложение откроется в отдельном окне со своим значком, и так как оно полностью работает в браузере, оно продолжит работать офлайн. Firefox на компьютере не умеет устанавливать веб-приложения. Как работает установка.