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

Зачем нужен lock-файл и почему его коммитят?

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

Lock-файл (package-lock.json, yarn.lock, pnpm-lock.yaml) записывает точные версии всех пакетов, включая вложенные. Благодаря ему у всех разработчиков и на сервере ставится одно и то же.

npm install      # может обновить lock-файл
npm ci           # ставит строго по lock-файлу, падает при расхождении

Зачем

  • package.json говорит ^1.2.0, а завтра выйдет 1.9.0. Без lock-файла у коллеги или на CI поставится другая версия, и «у меня работает» перестанет быть правдой.
  • Он фиксирует дерево транзитивных зависимостей и контрольные суммы, что защищает от подмены пакета.
  • Установка по lock-файлу быстрее — не нужно заново вычислять версии.

Правила

  • Коммитьте lock-файл приложения всегда.
  • В CI используйте npm ci: он ставит строго по lock-файлу и падает, если тот не совпадает с package.json.
  • Не правьте lock-файл руками и не держите в проекте два разных lock-файла.
  • Для библиотеки lock-файл не публикуется в npm, потому что у пользователей свои версии.

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

Lock-файл делает установку воспроизводимой. Его коммитят, а в CI ставят через npm ci.

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

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