[ERROR] npx 실행 시 npm 에러 발생하는 현상

발생원인

npx ... init 명령어로 설정파일 생성 중 예외 발생하는 현상 존재. 에러로그는 다음과 같다.

 

npm error could not determine executable to run
npm error A complete log of this run can be found in: C:\Users\test\AppData\Local\npm-cache\_logs\2025-10-...-0.log

 

해당 에러는 npm이 실행해야 할 프로그램을 찾지 못했거나, node.js 설치 경로(환경 변수) 가 꼬였을 때 주로 발생한다.

 

 

해결방법

 

우선 node -v 명령어와, npm -v 명령어로 node.js 와 npm 버전을 확인하여 정상 설치가 되었는지 확인한다.

둘 중 하나라도 나오지 않는 경우 node.js 재설치가 필요하다.

제어판에서 프로그램 추가/제거에서 node.js 삭제 후

node.js 사이트에서 LTS 버전 재설치 후,

설치 시 [Add to PATH], [Automatically install necessary tools] 2개 체크박스를 확인하여 설치 후 재부팅한다.

이후 프로젝트 폴더에서 재실행

 

만약 설치가 정상적으로 된 상태라면 npm 캐시를 초기화하여 깨진 실행 경로를 복구한다.

npm cache clean --force 명령어로 캐시 초기화 후 해결됨을 확인

 

만약 pnpm이나 yarn을 사용 중이라면 Vite가 기본 실행기로 잡아 꼬일 수 있다고 한다. 그럴 때는 명령어에 --yes 강제로 지정해주면 된다.