Node.js 설치 후 node 또는 npm 명령이 인식되지 않을 때

1. node와 npm의 실패를 따로 기록

node --version과 npm --version을 각각 실행해 결과를 적습니다. node까지 찾지 못하는 경우, node는 되지만 npm이 없는 경우, npm.ps1을 실행할 수 없다는 경우는 확인 순서가 다릅니다. 프로젝트의 코드 오류가 나오기 전에 명령 자체를 실행하지 못하는 증상인지 확인하세요. 버전이 이미 표시된다면 해당 명령은 실행된 것이므로 앱이나 패키지 단계의 오류를 별도로 봐야 합니다.

node --version
npm --version

2. 설치한 뒤 새 창에서 재확인

Node.js 설치 전에 열었던 PowerShell이나 편집기는 이전 환경을 유지할 수 있습니다. 새 외부 PowerShell을 열어 두 명령을 다시 실행하세요. 외부에서는 성공하고 VS Code 터미널에서만 실패하면 편집기 전체를 다시 시작한 후 통합 터미널을 엽니다. 같은 오류가 반복돼도 설치 파일을 여러 차례 겹쳐 실행하기 전에 어느 창에서 성공하는지 비교하면 원인을 줄일 수 있습니다.

3. 명령으로 선택되는 실제 파일 확인

PowerShell의 Get-Command는 현재 셸이 선택하는 명령을 보여 줍니다. -All로 후보를 확인하면 다른 설치 관리자가 만든 명령이나 오래된 실행 파일이 우선하는지 살펴볼 수 있습니다. 설치한 폴더와 출력 경로가 다르면 버전을 무작정 바꾸기보다 설치 방식을 정리해야 합니다. 공유할 때는 사용자 이름과 내부 폴더 경로를 가립니다.

Get-Command node -All
Get-Command npm -All

4. 설치형·ZIP·버전 관리자 구분

공식 다운로드는 여러 배포 방식을 제공합니다. Windows Installer로 설치한 경우와 ZIP을 풀어 사용한 경우의 PATH 등록 상태는 같지 않을 수 있습니다. 기존에 버전 관리자를 사용하는 프로젝트라면 그 도구가 선택한 Node.js와 새 설치형이 충돌할 수도 있습니다. package.json의 engines와 프로젝트 안내를 읽고 사용할 방식 하나를 기준으로 경로를 확인하세요. 설치 전의 PATH를 기록하지 않은 채 전체 값을 덮어쓰지 않습니다.

5. npm.ps1 차단은 런타임 실행과 구분

node 버전은 나오는데 npm.ps1에 대한 실행 정책 메시지가 표시되면 런타임 미설치와는 다른 문제입니다. 오류에 나온 파일과 Get-Command npm -All의 결과를 대조하고, 조직이 허용하는 실행 방법을 담당자에게 확인하세요. 보안 정책을 전체 해제하거나 출처를 모르는 우회 스크립트를 실행할 필요는 없습니다. 설치 파일에 포함된 명령 구성과 정책의 적용 범위를 먼저 확인합니다.

6. 정상화 확인과 다음 진단

경로를 조정한 뒤 새 셸에서 node와 npm 버전을 다시 읽고 다음 짧은 JavaScript를 실행합니다. 2가 표시되면 해당 셸에서 Node.js의 기본 실행이 확인된 것입니다. 이후 프로젝트 명령이 실패한다면 현재 작업 폴더와 잠금 파일·패키지 관리자·의존성 요구사항을 확인합니다. 지원 요청에는 설치 방식, 두 버전 명령의 결과와 오류 원문을 남기되 환경 변수 전체나 인증 토큰은 넣지 마세요.