Setup checkpoints

NestJS 설치 조건

Node, 패키지 매니저, Nest CLI, 프로젝트 폴더를 분리해서 확인하면 첫 실행 실패 원인을 빠르게 좁힐 수 있습니다.

첫 프로젝트 생성 전에 갖춰야 하는 조건

Node LTS

서버 런타임

NestJS 앱이 실행되는 기반이며 npm도 함께 설치됩니다.

npm 또는 Yarn

의존성 설치

패키지를 내려받고 package.json의 스크립트를 실행합니다.

Nest CLI

구조 생성 도구

프로젝트 기본 파일과 반복되는 모듈 생성을 표준화합니다.

Project folder

명령 실행 위치

package.json이 있는 폴더에서 설치와 실행 명령을 호출합니다.

start:dev

개발 서버

코드 변경을 감시하며 Nest 애플리케이션을 다시 시작합니다.

localhost

브라우저 응답

기본 컨트롤러까지 연결되었는지 Hello World 응답으로 확인합니다.

오류 메시지를 만났을 때 먼저 볼 위치

명령을 못 찾음 Node 또는 Nest CLI가 설치되지 않았거나 Path가 갱신되지 않았습니다. 새 터미널을 열고 버전 명령을 다시 실행합니다.
설치 실패 네트워크, 권한, 패키지 매니저 선택 문제가 섞일 수 있습니다. npm과 Yarn 중 하나로 통일하고 로그의 첫 오류를 확인합니다.
응답 없음 서버가 아직 올라오지 않았거나 3000번 포트가 충돌할 수 있습니다. 터미널 로그와 브라우저 주소를 함께 확인합니다.
학습 해석

환경 설정은 한 번에 성공하면 짧지만, 실패하면 단계별 경계가 중요해집니다. 런타임, CLI, 프로젝트, 서버 확인을 분리해 두면 다음 Nest 앱에서도 같은 순서로 점검할 수 있습니다.