[Next.js] 'next'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는배치 파일이 아닙니다.

npm run dev, npm run start를 작성했더니 'next'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는배치 파일이 아닙니다. 와 같은 오류 메세지가 떴다. 

 

npm install 또는 npm i를 작성한 뒤 실행하면 잘 동작한다.

 

npm install을 해야하는 이유는 다음과 같다.

 

1. 의존성 설치

프로젝트를 처음 clone 받았을 때, node_modules 폴더는 존재하지 않는다. 이 폴더는 프로젝트가 의존하는 모든 npm 패키지를 포함하며, package.json 파일에 정의된 의존성 목록에 따라 생성된다. npm install 명령어를 실행하면 package.json 파일에 정의된 모든 의존성을 다운로드하고 설치하여 node_modules 폴더를 생성한다.

2. package-lock.json 동기화

package-lock.json 파일은 npm이 설치한 정확한 패키지 버전을 기록한다. 이는 동일한 패키지 버전을 보장하여 프로젝트가 일관되게 동작하도록 한다. npm install 명령어는 이 파일을 읽고, 필요한 경우 업데이트하여 프로젝트가 예상한 대로 동작하도록 한다.

3. 패키지 설치와 스크립트 실행

next 명령어는 Next.js 패키지에서 제공하는 실행 파일이다. npm install을 실행하지 않으면 next 명령어를 찾을 수 없어서 next를 내부 또는 외부 명령어로 인식하지 못하는 오류가 발생한다. npm install을 통해 Next.js 패키지가 설치되면 next 명령어를 사용할 수 있게 된다.

 

따라서 git clone으로 파일을 모두 내려받았다면 npm start 이전에 npm install 명령어를 통해 package-json과 module를 업데이트 시켜주자!