Зачем нужен 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