У чому різниця між npm install і npm ci?

Повне пояснення

Що це і навіщо

• npm install – загальна команда для встановлення залежностей. Вона читає package.json, шукає потрібні пакети, встановлює їх і оновлює package-lock.json (або npm-shrinkwrap.json). Це корисно під час розробки, коли треба додати нові пакети або оновити існуючі.

• npm ci (clean install) призначений для CI/CD. Команда читає лише package-lock.json і встановлює точні версії, що зберігаються в ньому. Якщо package-lock.json не збігається з package.json, команда завершує роботу з помилкою. Це гарантує, що середовище збігається між різними машинами і часом.

Ключові принципи/терміни

• package-lock.json – файл, що фіксує точні версії залежностей.
• npm ci → чиста інсталяція: видаляє папку node_modules, встановлює залежності з нуля.
• npm install → інсталяція/оновлення: додає нові пакети, оновлює package-lock.json.

Як це працює

• При npm install npm перевіряє package.json, шукає відповідні пакети в реєстрі, встановлює їх і оновлює package-lock.json.
• При npm ci npm перевіряє, що package-lock.json існує і відповідає package.json. Якщо так – видаляє node_modules і встановлює залежності згідно з блоком lockfileVersion.

Практика й реалізація

• У локальній розробці: npm install (або yarn add).
• У CI‑пайплайнах: npm ci після клонування репозиторію.

Тестування

• У Jest‑тестах можна перевірити, що npm ci не змінює package-lock.json: після запуску npm ci файл залишається незмінним.

Оптимізація запитів

• npm ci швидше, бо пропускає кроки перевірки та оновлення lockfile.

Безпека

• Використання npm ci зменшує ризик непередбачуваних оновлень, що може викликати проблеми в продакшн‑середовищі.

Особливості у контексті DevOps

• npm ci підтримується в Docker‑build, GitHub Actions, GitLab CI тощо.

Часті помилки

• npm ci завершує роботу, якщо package-lock.json не синхронізований з package.json. Рішення: запустити npm install локально, закомітити оновлений lockfile.
• Якщо node_modules вже існує, npm ci видаляє його; це може зайняти час у великих проектах.

Cheatsheet

• npm install – розробка, додавання/оновлення.
• npm ci – CI/CD, стабільність, швидкість.