PassFront
  1. PassFront
  2. База знаний
  3. Менеджеры пакетов

Чем отличаются dependencies, devDependencies и peerDependencies в package.json?

Менеджеры пакетов

Это три способа сказать, зачем проекту нужен пакет. От этого зависит, что попадёт в продакшен и что установится у пользователей вашей библиотеки.

dependencies

Пакеты, без которых приложение не работает в рантайме: React, роутер, клиент API. Они ставятся всегда.

devDependencies

Нужны только при разработке: сборщик, линтер, тестовый фреймворк, типы. При npm install --omit=dev их не ставят, на сервере сборки они обычно нужны.

peerDependencies

Для библиотек. Говорят: «Я работаю с этим пакетом, но ставить его должен тот, кто меня использует». Например, библиотека React-компонентов объявляет react как peer, чтобы в приложении не оказалось две копии React.

{
  "dependencies": { "react": "^18.3.0" },
  "devDependencies": { "vitest": "^2.0.0", "typescript": "^5.5.0" },
  "peerDependencies": { "react": ">=18" }
}

Частая ошибка

Для фронтенд-приложения, которое собирается в статику, разница между dependencies и devDependencies почти не влияет на размер бандла: в него попадает только то, что импортируется в коде.

Коротко для собеседования

dependencies нужны в рантайме, devDependencies для разработки и сборки, peerDependencies для библиотек, которые рассчитывают на пакет хозяина.

Подробнее: npm — package.json

Другие вопросы раздела