Node.js프로젝트 설정

package.json과 scripts

`package.json`의 scripts, type, dependencies 필드를 중심으로 Node.js 프로젝트 기본 구성을 정리합니다.

마지막 수정 2026년 3월 19일

기본 패턴

json
{
  "name": "sample-node-app",
  "type": "module",
  "scripts": {
    "dev": "node --watch src/index.js",
    "start": "node src/index.js"
  }
}

설명

  • package.json은 프로젝트 이름, 실행 스크립트, 의존성, 모듈 방식 같은 정보를 담습니다.
  • scripts를 잘 잡아두면 실행 명령을 팀 전체가 동일하게 쓸 수 있습니다.
  • type: "module"을 두면 기본적으로 ESM 문법을 쓰게 됩니다.

짧은 예제

bash
npm run dev
npm run start

빠른 정리

필드역할
name패키지 이름
scripts실행 명령 모음
dependencies런타임 의존성
typeCommonJS / ESM 방식

주의할 점

CommonJS 예제와 ESM 예제를 섞어 쓰면 require is not defined 같은 오류가 나기 쉬우니, 프로젝트 모듈 방식을 먼저 고정하세요.