Урок 032 минуты чтения
Чем отличаются dependencies и devDependencies?
На этой странице
Кратко
dependencies - это пакеты, которые нужны приложению во время работы, а devDependencies - инструменты, которые нужны только для разработки, тестов, сборки и линтинга.
Вопрос
Чем отличаются dependencies и devDependencies и куда класть ту или иную зависимость?
Главное
{
"dependencies": {
"express": "^5.0.0"
},
"devDependencies": {
"vitest": "^3.0.0",
"eslint": "^9.0.0"
}
}express нужен серверу в runtime. eslint нужен разработчику и CI, но не самому приложению в production.
dependencies
Сюда кладут то, без чего приложение не запустится:
- web-framework;
- клиент базы данных;
- библиотека логирования;
- validation library;
- runtime SDK.
devDependencies
Сюда кладут инструменты разработки:
- test runner;
- TypeScript;
- ESLint;
- Prettier;
- bundler;
- генераторы типов.
Почему это важно
В production-сборках часто устанавливают только production-зависимости.
npm install --omit=devЕсли runtime-пакет случайно лежит в devDependencies, приложение может сломаться на сервере.
Версионные диапазоны
{
"dependencies": {
"lodash": "^4.17.21"
}
}Символ ^ разрешает совместимые обновления по semver. Точный результат установки фиксирует lockfile.
Что важно помнить
dependenciesнужны в рантайме,devDependencies— только для разработки, тестов и сборки.npm ci --omit=devне ставит devDependencies — production-образ становится меньше.- Для библиотек важны
peerDependencies: React, например, указывают как peer, а не как прямую зависимость. - Во frontend-приложениях с бандлером граница условна, но разделение всё равно помогает в CI.
Мини-шпаргалка
dependenciesнужны приложению в runtime.devDependenciesнужны для разработки и CI.- Сервер может ставить зависимости без dev.
- Ошибка в категории зависимости может сломать deploy.
- Lockfile фиксирует дерево установленных версий.
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.