기록하다

VScode에서 npm start 를 했을 때 나는 오류 해결 법.

메슈어 2025. 2. 19. 20:35 
PS C:\Users\**\문서\GitHub\salad-game> npm start
npm : 'npm' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다. 이름이 정확한지 확인하
고 경로가 포함된 경우 경로가 올바른지 검증한 다음 다시 시도하십시오.
위치 줄:1 문자:1
+ npm install
+ ~~~
    + CategoryInfo          : ObjectNotFound: (npm:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

📌 1. Node.js 설치 확인

터미널(또는 PowerShell)에서 다음 명령어 실행:

 
node -v

또는

npm -v

만약 버전 정보가 나오지 않는다면, Node.js가 설치되지 않은 것

(*만약 npm 설치 직후라면, VScode 또는 Cmd창을 모두 닫고 다시 켜보길) 그래도 안되면 다음으로 ㄱㄱ

설치가 이미 된 상태라면 2번으로 점프!

👉 해결 방법

  1. Node.js 공식 사이트에서 설치
    • 다운로드 링크 로 이동하여 LTS(Long Term Support) 버전을 다운로드
    • Windows 사용 시 기본 설정(Default) 으로 설치 진행
    • 설치 후, 터미널을 재시작한 뒤 node -v, npm -v 확인

📌 2. 환경 변수(PATH) 설정 확인 (Windows)

Node.js가 설치되었는데도 npm을 찾을 수 없다면, 환경 변수에 문제가 있을 수 있음..

👉 해결 방법

  1. Win + R → sysdm.cpl 입력 후 실행 (시스템 속성 창 열기)
  2. 고급 탭 → 환경 변수 버튼 클릭
  3. 시스템 변수(SYSTEM VARIABLES)에서 Path 항목을 찾기
  4. Path를 더블 클릭 → 아래 항목이 포함되어 있는지 확인
    makefile
    복사편집
    C:\Program Files\nodejs\ C:\Users\사용자명\AppData\Roaming\npm
  5. 만약 없다면 직접 추가 후 재부팅
  6. 터미널에서 npm -v 실행하여 정상 동작 확인

📌 3. VS Code 터미널에서 PowerShell 대신 cmd 사용

PowerShell에서는 실행 정책 때문에 npm이 동작하지 않을 수도 있음.

👉 해결 방법

  • PowerShell을 닫고 VS Code에서 새 터미널을 연 후 cmd 실행
  • 또는 VS Code에서 기본 터미널을 cmd로 변경
    1. Ctrl + Shift + P → "Select Default Profile" 입력
    2. Command Prompt (cmd) 선택 후 VS Code 재시작

📌 4. Node.js & npm 재설치

위 방법으로도 해결되지 않으면 Node.js와 npm을 완전히 제거한 후 재설치해야 해.

👉 해결 방법

  1. 기존 Node.js 삭제
    • 제어판 → 프로그램 제거 → Node.js 삭제
    • C:\Program Files\nodejs 폴더 삭제
  2. 새로운 Node.js 설치