motdotla/dotenv

Что это?

Ключевые возможности

• 01Загружает пары «ключ-значение» из .env в process.env одним вызовом config().
• 02Предоставляет parse() для преобразования строки или Buffer в объект.
• 03Предоставляет populate() для записи значений в произвольный целевой объект.
• 04Включает CLI с командой dotenv run, которая добавляет переменные перед запуском команды.
• 05Поддерживает последовательную загрузку нескольких env-файлов с возможностью включить override.
• 06Не имеет зависимостей и поддерживает ESM-импорты через dotenv/config.

Сценарии использования

• Хранение API-ключей и URL баз данных отдельно от исходного кода сервиса на Node.js.
• Использование разных файлов .env для локальной, тестовой и рабочей сред.
• Добавление переменных окружения при запуске тестовых команд или скриптов с помощью dotenv run.
• Разбор текста в формате env в собственном инструменте с помощью функции parse().

Быстрый старт

1. 1

   Установите dotenv с помощью npm

   npm install dotenv --save
2. 2

   Создайте файл .env в корне проекта и укажите в нём переменные

3. 3

   Загрузите dotenv в начале приложения

4. 4

   Запустите приложение с помощью node

   node index.js

Что важно знать

• !Для подстановки переменных и выполнения команд требуется отдельный инструмент dotenvx.
• !Комментарии начинаются с #, если значение не заключено в кавычки. Это несовместимое изменение по сравнению с v15.

В подборках

Темы

Частые вопросы

Что такое dotenv?

Модуль для Node.js без зависимостей: загружает переменные окружения из файла .env в process.env. dotenv загружает пары «ключ-значение» из файла .env в process.env в приложениях Node.js. Это позволяет хранить конфигурацию и секреты отдельно от исходного кода в соответствии с подходом Twelve-Factor App. Для этого в корне проекта создают файл .env, как можно раньше вызывают config(), а затем, как обычно, получают значения через process.env.

dotenv можно использовать бесплатно? Какая у него лицензия?

dotenv распространяется с открытым исходным кодом под лицензией BSD-2-Clause. Перед использованием в коммерческих продуктах проверьте условия лицензии.

dotenv всё ещё поддерживается?

Активно поддерживается. Последний коммит в dotenv — 29 окт. 2026 г..

Для чего можно использовать dotenv?

Хранение API-ключей и URL баз данных отдельно от исходного кода сервиса на Node.js. Использование разных файлов .env для локальной, тестовой и рабочей сред. Добавление переменных окружения при запуске тестовых команд или скриптов с помощью dotenv run. Разбор текста в формате env в собственном инструменте с помощью функции parse().

Как установить dotenv?

Установите dotenv с помощью npm: npm install dotenv --save Создайте файл .env в корне проекта и укажите в нём переменные Загрузите dotenv в начале приложения Запустите приложение с помощью node: node index.js

Где скачать dotenv?

Исходный код и инструкции по установке — на GitHub: https://github.com/motdotla/dotenv