[NPM] npm i 과 npm ci … 차이점은?

📌 npm i (npm install)

npm i(npm install) 는 프로젝트에 필요한 패키지를 설치하기 위해 사용하는 명령어입니다.

npm i 는 크게 두가지 방식으로 동작합니다.

1️⃣ 특정 패키지 설치

$ npm install "package-name"

특정 패키지를 설치할 경우 npm i (name) 과 같은 형식으로 사용합니다.

이외에도 사용 가능한 명령어 형식이 정말 다양한데, 자세한 내용은 공식문서 를 참조하시면 됩니다.

 

2️⃣ 프로젝트가 의존하고 있는 모든 패키지 설치

$ npm install

특정 패키지명을 명시하지 않을 경우에는 package.json 에 명시되어있는

모든 의존 패키지를 설치해 node_modules 에 적재하는 것이 가능합니다.

💡 두 방식의 공통점

두 방식 모두 package-lock.json 을 먼저 확인하고 만약 존재하면

해당 lockfile 을 이용해서 의존하고 있는 패키지 정보를 파악하고 node_modules 에 설치합니다.

그리고 node_modules 나 package.json 에 변화가 생기면

package-lock.json 을 업데이트하여 의존 패키지 정보를 기록합니다.

 

📌 npm ci (npm clean-install)

npm ci 는 package-lock.json 에 명시되어있는 패키지 정보를 활용해서

완전히 정확한 버전의 패키지들을 설치해서 node_modules 에 적재합니다.

따라서 해당 명령어로 패키지를 설치하는 모든 개발자들이

동일한 버전의 패키지를 사용하고 있음을 보장할 수 있습니다.

 

또한 npm i 와는 다르게 절대 package-lock.json 을 수정하지 않습니다.

그리고 이 lockfile 을 기반으로 동작하기 때문에 해당 파일이 반드시 필요합니다.

 

📌 그래서 언제, 어떤것을 써야할까요?

다음은 자주 발생하는 각각의 경우에 대해서 어떤 명령어를 통해서

필요한 패키지를 설치하는 것이 좋을 지에 대한 개인적인 의견입니다. 😀

1️⃣ 새로운 패키지를 프로젝트에 추가할 때

npm install "package name" 을 사용해서 필요한 패키지를 설치합니다.

2️⃣ 원격 저장소의 프로젝트를 로컬에 초기 설정할 때

다른 개발자들과 함께 작업하는 프로젝트의 초기 설정을 진행할 때는

npm ci 를 통해서 현재 저장소의 package-lock.json 을 기반으로 패키지를 설치합니다.

3️⃣ 자동화 테스트 및 CI/CD 환경

수 많은 빌드 과정에서 package-lock.json 을 수정하지 않기 위해 npm ci 를 사용합니다.

 

📌 참고자료

npm ci vs. npm install - Which Should You Use in Your Node.js Projects?

Difference between npm i and npm ci in Node.js - GeeksforGeeks