컴맹도 5분컷 내는 npm install 오류 해결 방법 5가지

터미널에 npm install을 입력했는데 빨간 글씨로 오류가 뜹니다.

npm ERR! 로 시작하는 메시지만 보이고, 뭘 눌러야 할지 모르겠습니다.

프로젝트를 실행하려 해도 install부터 막혀서 진행이 안 됩니다.

npm install 오류는 초보자가 가장 많이 만나는 문제 중 하나입니다.

 

 

 

 

 

 

원인

• node_modules 폴더 손상
• package-lock.json 충돌
• Node.js 버전 불일치
• 캐시 파일 손상
• 권한(permission) 문제

대부분 npm install 오류는 캐시나 파일 충돌 때문에 발생합니다.

 

 

 

 

 

 

 

 

해결 방법

 

Step 1. npm 캐시 삭제

npm cache clean --force

캐시가 오염되면 npm install 오류가 반복됩니다. 먼저 캐시를 지웁니다.

 

 

 

 

 

 

 

 

Step 2. node_modules와 package-lock.json 삭제 후 재설치

rm -rf node_modules package-lock.json
npm install

윈도우는 폴더를 직접 삭제하거나 아래 명령어를 사용합니다.

 

rmdir /s /q node_modules
del package-lock.json
npm install

 

 

 

 

 

 

 

Step 3. Node.js 버전 확인

node -v
npm -v

프로젝트가 요구하는 버전과 다르면 npm install 오류가 계속 발생합니다.

nvm을 사용해 버전을 맞춰줍니다.

nvm install 18
nvm use 18

 

 

 

 

 

Step 4. 권한 오류일 경우

 

EACCES 오류가 보이면 권한 문제입니다.

sudo chown -R $(whoami) ~/.npm

윈도우는 터미널을 관리자 권한으로 다시 실행합니다.

 

 

 

 

 

 

Step 5. 그래도 안 되면 npm 재설치

npm install -g npm@latest

npm 자체가 손상된 경우 최신 버전으로 재설치하면 해결됩니다.

 

 

 

 

 

 

추가 팁

• package.json을 직접 수정한 적이 있다면 문법 오류부터 확인하세요.
• 회사/학교 네트워크라면 프록시 설정이 npm install 오류의 원인일 수 있습니다.
• VPN 사용 중이면 잠시 꺼보고 재시도하세요.

 

 

npm install 오류는 대부분 캐시 삭제, node_modules 재설치, 버전 확인으로 해결됩니다.

Step 1부터 순서대로 시도하면 대부분 바로 해결됩니다.