Setup

Node/npm 실행 환경 고정

Next.js 프로젝트는 설치 성공보다 재현 가능한 실행 환경이 중요하다. Node 버전과 lockfile, 스크립트 경로가 어긋나면 같은 코드도 다르게 움직인다.

01

버전 기록

node -v와 패키지 관리자 버전을 프로젝트 문서나 엔진 설정과 맞춘다.

02

lockfile을 하나만 둔다

서로 다른 lockfile이 공존하면 팀마다 다른 의존성 트리가 생길 수 있다.

03

빌드와 개발 분리

dev 서버 통과와 production build 통과는 다른 검증이다. 둘 다 확인해야 한다.

dev
개발 서버 빠른 피드백과 HMR을 제공하지만 production 최적화와 다르다.
성능 판단은 build 뒤에 한다.
build
프로덕션 산출물 생성 정적 분석, 라우트 생성, 번들 최적화 과정에서 숨은 오류가 드러난다.
배포 전 필수 관문이다.
start
빌드 결과 실행 next build 이후 production 서버로 동작을 확인한다.
dev와 캐시 동작이 다를 수 있다.
lock
재현성 같은 lockfile로 설치해야 CI와 로컬의 의존성 차이가 줄어든다.
패키지 관리자 혼용을 피한다.

버전 · 설치 · 검증 점검

버전 현재 Node 버전이 프로젝트 요구 범위와 맞는가.
설치 lockfile과 다른 패키지 관리자를 섞어 install하지 않았는가.
검증 dev 실행뿐 아니라 build까지 통과했는가.

환경 확인

node -v
npm -v
npm run dev
npm run build