JavaScript 애플리케이션 개발을 해보셨다면 Node.js를 접해보셨을 것입니다. Node.js에는 다양한 도구들이 존재하며, npm(Node Package Manager)은 이러한 도구들을 효율적으로 관리할 수 있게 도와줍니다. npm은 필요한 패키지를 설치하고, 터미널 인터페이스를 제공하여 도구와 패키지를 손쉽게 다룰 수 있도록 지원합니다.
그런데 최신 버전으로 업데이트한 후 터미널에서 npm start 명령어를 실행했을 때 missing script: start라는 메시지가 나타난 적이 있으신가요? 아니면 node Filename.js처럼 파일을 직접 실행하면서 정작 package.json에 start 스크립트가 정의되어 있지 않은 경우에도 같은 오류가 발생합니다. 물론 그 외에도 여러 가지 원인이 있을 수 있습니다.
어떤 경우든 아래의 단계를 따라 하면 오류 메시지 없이 npm start 명령어를 정상적으로 실행할 수 있습니다.
npm ERR! missing script: start 오류의 원인은 무엇일까?
터미널에 npm start를 입력했을 때 npm err! missing script: start 오류가 발생한다면, package.json 파일의 scripts 객체에 해당 스크립트 항목이 빠져 있다는 뜻입니다. 오류 메시지는 누락된 내용이 바로 start 명령어와 관련이 있음을 알려줍니다.
npm start 명령어 실행 후 발생하는 오류 화면
오류 메시지 해결 방법
이제 이 오류를 해결하기 위해 취할 수 있는 단계들을 살펴보겠습니다. 프로젝트의 package.json 파일에 start 스크립트를 추가하여 npm start 명령어를 사용할 수 있도록 만들어 보겠습니다.
- 1단계: 먼저 터미널에서 npm init을 입력하여 package.json 파일로 이동합니다. 그러면 package.json 파일 생성 과정이 진행됩니다. 유틸리티가 프로젝트 이름, 진입 파일명 등 몇 가지 기본 정보를 묻습니다. 저는 작업 중인 파일 이름이 "App.js"였기 때문에 "entry point(진입점)" 항목에 해당 이름을 입력했습니다. 각자에게 맞는 값을 입력하거나, 기본값을 그대로 사용하려면 Enter 키를 누르면 됩니다.
- 2단계: 이제 해당 파일의 위치로 이동해 열어봅니다. package.json 파일은 터미널에서 현재 작업 중인 디렉터리에 저장됩니다. 저는 사용자 디렉터리("App.js" 파일이 있는 곳)에서 작업했기 때문에 그곳에서 파일을 찾았습니다. 그다음 package.json 파일의 "scripts" 객체 안에 start 스크립트를 추가합니다. 이렇게 하면 npm start 명령어가 정상적으로 동작하게 됩니다.
2단계에서 추가한 스크립트가 강조된 모습
- 3단계: 마지막으로 npm start를 다시 실행합니다. 이제는 오류 없이 성공적으로 실행될 것입니다!
마무리
이번 글에서는 package.json 파일의 한 줄을 수정하여 npm start 명령어가 정상 작동하도록 만드는 방법을 배웠습니다. 보셨듯이 발생한 오류 메시지는 꽤 상세했습니다. 바로 start 명령어 관련 스크립트가 누락되었다는 것이었죠!
앞서 살펴본 해결 방법에서는 스크립트가 정의되어 있는 package.json 파일을 열고 start 스크립트를 추가했습니다. 오류가 발생했을 때는 반드시 오류 설명을 자세히 읽고 해결 단서를 찾아보세요!
npm에 대해 더 깊이 학습하고 싶다면, npm을 배우기 좋은 추천 리소스를 정리한 글도 참고해 보세요. 행운을 빕니다!