re:re:actable
Урок 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 фиксирует дерево установленных версий.

Документация

npm: dependencies, npm: devDependencies.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам