개발 환경은 실행 명령, 포트, next.config.ts, 환경 변수를 한 번에 점검한다
설정은 서로 연결되어 있다. 서버가 켜지는지뿐 아니라 어떤 값이 브라우저와 서버 코드에 노출되는지도 함께 확인한다.
| 점검 항목 | 보는 위치 | 확인할 것 | 주의 |
|---|---|---|---|
| 실행 명령 | package.json scripts | dev가 next dev로 연결되는지 | 다른 패키지 매니저와 섞지 않기 |
| 포트 | 터미널 환경 변수 | 3000 또는 지정 포트가 비어 있는지 | Windows 셸마다 문법이 다름 |
| Next 설정 | next.config.ts | images.remotePatterns, strict mode, experimental 옵션 | 변경 후 서버 재시작 필요 가능 |
| 환경 변수 | .env.local | 무접두사는 서버 전용, NEXT_PUBLIC_만 공개 | 비밀값을 next.config.ts env나 NEXT_PUBLIC_에 넣지 않기 |
| 브라우저 확인 | localhost | 화면, 오류 오버레이, console | 터미널 로그와 함께 봄 |