npm 이 정상적으로 동작하지 않는다면?

❓ 문제

노트북 포맷 후 node 설치했다. 그러나 터미널에서 npm 명령어가 실행되지 않았다.

* 윈도우 기준입니다.

✔️ 문제 상황 파악하기

node 버전 확인

node -v

     v22.13.1 출력 되지만
     npm -v  오류가 나타남

✅ Case 1. npm 이 제대로 설치되지 않았을 경우

  npm 설치되어 있는지 확인하기

where npm

  만약 출력이 없다면 npm이 설치되지 않았을 가능성이 있습니다.

해결 방법

Node.js를 다시 설치

npm install -g npm

 

✅ Case  2. 환경 변수(PATH) 문제

npm이 설치되어 있지만, 환경 변수에 등록되지 않아 실행이 되지 않을 수 있습니다.

해결 방법

1) 환경 변수 확인

C:\Program Files\nodejs\npm 또는 C:\Users\사용자이름\AppData\Roaming\npm 경로가 PATH 환경 변수에 포함되어 있는지 확인하세요.

2) PATH에 npm 경로 추가

 

• 시스템 환경 변수 편집 실행 → 환경 변수 클릭
• 시스템 변수 또는 사용자 변수에서 Path 편집
• C:\Users\사용자이름\AppData\Roaming\npm 추가
• 확인 후 터미널 다시 실행

참고 : https://imspear.tistory.com/31

 

✅ Case  3. npm 자체가 손상됨

npm 이 손상되어 실행되지 않는 경우, npm을 수동으로 재설치해야 할 수도 있습니다.

해결 방법

npm cache clean --force
npm install -g npm

설치 후 버전 확인하기

npm -v

 

위의 방법으로도 해결이 되지 않았다면?

✅ Case  4. Node.js 재설치 

 

• 기존 Node.js 삭제
• Node.js 공식 사이트에서 최신 버전 다운로드 후 설치
• 다시 node -v, npm -v 확인

---

❓그래도 실행되지 않는다면??

npm 이 설치는 되어 있지만 실행이 안되는 문제로
환경 변수도 잘못 설정된 경우는 아니였습니다.

저의 경우는 PowerShell의 실행 정책 문제로 인해 발생하는 것으로
Windows에서는 보안 정책상 특정 스크립트 실행을 제한하고 있어서 발생한 문제로 아래처럼 해결했습니다.

 

✅ Case 5. PowerShell 실행 정책 확인 및 변경

해결방법

1) 실행 정책 확인
PowerShell을 관리자 권한으로 실행한 후, 아래 명령어를 입력하세요

Get-ExecutionPolicy

 

출력값이 Restricted 또는 AllSigned 이라면, 현재 스크립트 실행이 제한된 상태입니다.
저는 Restricted 출력되었으며 현재 스크립트 실행이 제한된 상태였습니다.

2) 실행 정책 변경
PowerShell(관리자 권한)에서 아래 명령어를 입력하여 실행 정책을 일시적으로 변경합니다.

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

실행 정책을 변경할지 묻는다면?  Y 를 입력한 후 엔터를 누릅니다.

! 만약 여전히 문제가 발생한다면, 다음 명령어를 실행해보세요

Set-ExecutionPolicy Unrestricted -Scope CurrentUser

3) npm 명령어 다시 실행
이제 다시 npm을 설치해 보세요.

npm install -g npm

npm -v  정상적으로 버전이 출력되는지 확인하기

4) 설치 후 실행 정책 원래대로 복구
설치가 정상적으로 완료되었다면 보안을 위해 원래 상태로 되돌리는 것이 좋습니다.

Set-ExecutionPolicy Restricted -Scope CurrentUser

 

저의 경우는 원래 상태로 되돌리면 같은 문제가 발생하여 실행 정책 변경없이 npm 실행(대체 방법) 하였습니다.

5) 실행 정책 변경 없이 npm 실행

"C:\Program Files\nodejs\npx.cmd" npm install -g npm