Чем отличаются 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