npm install과 npm ci 차이는?

npm install은 package.json을 기준으로 설치하며 package-lock.json을 갱신할 수 있습니다. npm ci는 package-lock.json을 정확히 따르고 node_modules를 먼저 삭제한 뒤 새로 설치합니다. CI/CD 환경이나 재현 가능한 빌드가 필요할 때는 npm ci를 사용하세요.

npm과 yarn, pnpm 중 무엇을 써야 하나요?

npm은 Node.js에 기본 포함되어 별도 설치가 필요 없습니다. yarn은 워크스페이스 기능이 강력하고, pnpm은 하드링크 방식으로 디스크 공간을 크게 절약합니다. 팀이 쓰는 것을 따르되, 신규 프로젝트라면 pnpm을 추천합니다.

npx와 npm run의 차이는?

npm run은 package.json의 scripts에 정의된 명령만 실행합니다. npx는 로컬 node_modules나 npm 레지스트리의 패키지를 설치 없이 바로 실행합니다. create-react-app처럼 일회성 도구를 실행할 때 npx가 유용합니다.

npm 명령어 모음

패키지 설치·스크립트 실행·npx, yarn/pnpm 대응까지

데이터는 서버로 전송되지 않습니다 — 모든 처리는 브라우저 안에서만 서버 전송 0건

프로젝트 초기화

npm init -y

기본값으로 package.json을 즉시 생성합니다
npm init

대화형으로 package.json을 생성합니다
npm create vite@latest

Vite 기반 프로젝트를 생성합니다
npx create-react-app 앱이름

React 앱을 생성합니다 (CRA)

패키지 설치

npm install

package.json의 모든 의존성을 설치합니다
npm install 패키지명

패키지를 설치하고 dependencies에 추가합니다
npm install -D 패키지명

패키지를 devDependencies에 추가합니다 (빌드 툴 등)
npm install -g 패키지명

전역으로 패키지를 설치합니다
npm install 패키지명@1.2.3

특정 버전을 설치합니다
npm install 패키지명@latest

최신 버전을 설치합니다
npm ci

package-lock.json 기준으로 정확히 설치합니다 (CI 환경 권장)

패키지 제거·업데이트

npm uninstall 패키지명

패키지를 제거하고 package.json에서도 삭제합니다
npm update

모든 패키지를 허용 버전 범위 안에서 업데이트합니다
npm update 패키지명

특정 패키지를 업데이트합니다
npm outdated

업데이트 가능한 패키지 목록을 확인합니다

스크립트 실행

npm run 스크립트명

package.json의 scripts에 정의된 명령을 실행합니다
npm start

start 스크립트를 실행합니다 (개발 서버 등)
npm run build

build 스크립트를 실행합니다 (프로덕션 빌드)
npm test

test 스크립트를 실행합니다
npx 패키지명 [옵션]

설치 없이 패키지를 임시로 실행합니다

패키지 조회·정보

npm list

현재 프로젝트의 의존성 트리를 출력합니다
npm list --depth=0

직접 설치한 패키지만 출력합니다
npm list -g --depth=0

전역 설치 패키지를 확인합니다
npm info 패키지명

npm 레지스트리에서 패키지 정보를 조회합니다
npm view 패키지명 versions

사용 가능한 버전 목록을 확인합니다

캐시·설정

npm cache clean --force

npm 캐시를 강제로 삭제합니다 (설치 오류 해결에 유용)
npm config list

현재 npm 설정을 출력합니다
npm config set registry https://registry.npmjs.org/

npm 레지스트리를 초기화합니다
npm audit

보안 취약점을 스캔합니다
npm audit fix

자동으로 수정 가능한 취약점을 패치합니다

yarn / pnpm 대응 명령어

npm 대신 yarn 또는 pnpm을 쓸 때 동일한 역할의 명령어입니다

yarn add 패키지명

yarn: 패키지를 설치합니다 (npm install 패키지명)
yarn add -D 패키지명

yarn: devDependencies에 설치합니다
pnpm add 패키지명

pnpm: 패키지를 설치합니다 (디스크 효율 최적)
pnpm install

pnpm: 전체 의존성을 설치합니다

npm, package.json이 프로젝트의 설명서입니다

npm은 Node.js 생태계의 표준 패키지 관리자입니다. npm install로 의존성을 설치하고, npm run build/start로 스크립트를 실행하는 기본 흐름을 익히면 대부분의 프론트엔드·Node.js 프로젝트를 다룰 수 있습니다. package-lock.json은 반드시 커밋에 포함해서 팀원이 동일한 버전으로 설치할 수 있도록 하세요.

yarn과 pnpm은 npm과 명령어가 거의 유사하지만 내부 동작 방식이 다릅니다. pnpm은 디스크 사용량을 크게 줄여주고 설치 속도도 빠릅니다. 모노레포 구조라면 npm workspaces, yarn workspaces, 또는 pnpm workspaces를 활용해보세요.

자주 묻는 질문

npm install과 npm ci 차이는?: npm install은 package.json을 기준으로 설치하며 package-lock.json을 갱신할 수 있습니다. npm ci는 package-lock.json을 정확히 따르고 node_modules를 먼저 삭제한 뒤 새로 설치합니다. CI/CD 환경이나 재현 가능한 빌드가 필요할 때는 npm ci를 사용하세요.
npm과 yarn, pnpm 중 무엇을 써야 하나요?: npm은 Node.js에 기본 포함되어 별도 설치가 필요 없습니다. yarn은 워크스페이스 기능이 강력하고, pnpm은 하드링크 방식으로 디스크 공간을 크게 절약합니다. 팀이 쓰는 것을 따르되, 신규 프로젝트라면 pnpm을 추천합니다.
npx와 npm run의 차이는?: npm run은 package.json의 scripts에 정의된 명령만 실행합니다. npx는 로컬 node_modules나 npm 레지스트리의 패키지를 설치 없이 바로 실행합니다. create-react-app처럼 일회성 도구를 실행할 때 npx가 유용합니다.

npm, package.json이 프로젝트의 설명서입니다

자주 묻는 질문

관련 툴