[VS Code] 'npm' 명령어 인식 오류 해결 방법

npm 이란? 
Node.js의 패키지를 관리할 수 있는 도구.
일반적인 경우에는 Node.js를 설치하면 자동으로 설치된다.

내용

Visual Studio Code에서 프로젝트를 시작하려고 npm 명령어를 입력했는데, ‘npm’은 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다 라는 메시지가 나왔어요. 저도 처음엔 당황했는데, 이 문제는 대부분 'Node.js 경로(PATH)' 설정이 잘못됐을 때 발생하는 거더라고요.

npm : 'npm' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다. 이름이 정확한지 확인하고 경로가 포함된 경우 경로가 올바른지 검증한 다음 다시 시도하십시오.

npm 오류 메시지 스크린샷

---

CASE 1. Node.js가 제대로 설치되지 않았을 때

npm은 Node.js와 함께 설치되는 패키지 관리자입니다. 따라서 먼저 Node.js가 설치되어 있어야 npm도 사용할 수 있어요.

1. https://nodejs.org/eng/en/download 접속
2. Node.js 설치
   - 설치 내용 중에 'npm package manager' 가 포함되어 있다.
   

   

   Node.js 공식 홈페이지 다운로드 페이지

3. VSCode 재시작
4. 설치가 끝나면, 터미널에서 아래 명령어로 정상 설치 여부를 확인할 수 있어요.
     node -v
     npm -v
   버전 정보가 출력되면 정상적으로 설치된 거예요.
   만약 여전히 오류가 난다면, 환경 변수 설정이 제대로 안 된 걸 수 있어요.

---

CASE 2. VS Code 기본 터미널 문제

VS Code에서 기본 터미널이 PowerShell로 되어 있을 경우, 일부 명령어가 작동하지 않을 수 있어요. 이럴 땐 명령 프롬프트(CMD)로 바꿔보는 걸 추천드려요.

 

변경 방법은 아래와 같아요:

1. 터미널 우측 + 클릭 → Select Default Profile 선택
   또는 VS Code 상단 메뉴에서 Ctrl + Shift + P 를 누르고 Terminal: Select Default Profile 입력
   

   

   VS Code에서 기본 터미널 설정 변경 화면

2. 상단에 Command Prompt 선택
   

   

   VS Code에서 기본 터미널 설정 변경 화면

3. 새 터미널을 열면 CMD로 실행돼요

이 상태에서 다시 npm -v 를 입력해 보세요.
정상적으로 버전이 출력된다면 문제 해결된 거예요!

 

 

 

이 외에도 Visual Studio Code의 터미널 문제는 다양한 원인으로 발생할 수 있어요.
이번 글에서 소개한 두 가지 방법이 가장 일반적인 해결책이니, 차례로 시도해 보시면 대부분 해결되실 거예요.