프로그래밍/Nest.js

Nest.js 설치 및 설정: 설치 방법

shimdh 2025. 3. 16. 20:46
728x90

Nest.js는 Node.js를 기반으로 한 현대적인 웹 애플리케이션 프레임워크로, 효율적이고 확장 가능한 서버 측 애플리케이션을 구축하는 데 큰 도움을 줍니다. 이 블로그 포스트에서는 Nest.js를 설치하고 설정하는 방법에 대해 자세히 살펴보겠습니다. 각 단계마다 필요한 세부 사항과 유용한 팁을 제공하여, 여러분이 Nest.js를 보다 쉽게 이해하고 활용할 수 있도록 돕겠습니다.

1. Node.js와 npm 확인

Nest.js를 사용하기 위해서는 먼저 Node.js와 npm(노드 패키지 관리자)이 시스템에 설치되어 있어야 합니다. 이를 확인하려면 터미널 또는 명령 프롬프트에서 다음 명령어를 입력합니다:

node -v
npm -v

이 명령어들은 각각 Node.js와 npm의 버전을 출력합니다. 만약 설치되어 있지 않다면 Node.js 공식 웹사이트에서 다운로드하여 설치할 수 있습니다. 설치 후, 최신 버전이 설치되었는지 확인하는 것이 중요합니다. 최신 버전은 보안과 성능 향상에 기여하므로, 항상 업데이트된 상태를 유지하는 것이 좋습니다.

2. Nest CLI 설치

Nest CLI(Command Line Interface)는 Nest.js 프로젝트를 쉽게 생성하고 관리할 수 있는 도구입니다. CLI를 전역적으로 설치하려면 다음 명령어를 실행합니다:

npm install -g @nestjs/cli

설치가 완료되면 nest 명령어가 정상적으로 작동하는지 확인합니다:

nest --version

이 명령어를 통해 설치된 Nest CLI의 버전을 확인할 수 있으며, 이를 통해 설치가 제대로 이루어졌는지 검증할 수 있습니다. Nest CLI는 프로젝트 생성뿐만 아니라, 다양한 명령어를 통해 프로젝트의 구조를 관리하고, 필요한 모듈을 추가하는 데에도 유용합니다.

3. 새로운 프로젝트 생성

이제 새로운 Nest.js 프로젝트를 생성해 보겠습니다. 원하는 디렉토리로 이동한 후, 다음과 같은 명령어로 새 프로젝트를 만들 수 있습니다:

nest new project-name

여기서 project-name은 여러분이 만들고자 하는 프로젝트의 이름입니다. 이 과정에서 몇 가지 질문이 나오며, 기본값을 선택하거나 필요에 따라 다른 옵션을 선택할 수 있습니다. 예를 들어, 패키지 관리자를 선택하는 단계에서는 npm 또는 yarn 중 하나를 선택할 수 있습니다. 각 패키지 관리자는 고유한 장점이 있으므로, 여러분의 개발 스타일에 맞는 것을 선택하는 것이 좋습니다.

프로젝트가 성공적으로 생성되면 해당 디렉토리로 이동하여 아래의 커맨드를 통해 의존성을 설치합니다:

cd project-name 
npm install 

이 단계에서 의존성 설치가 완료되면, 프로젝트의 기본 구조가 생성되고, 필요한 라이브러리들이 자동으로 설치됩니다.

4. 개발 서버 실행

프로젝트가 준비되었다면 이제 개발 서버를 실행해 볼 차례입니다. 아래의 커맨드를 입력하면 기본적인 Nest 애플리케이션이 실행됩니다:

npm run start:dev 

서버가 성공적으로 실행되면 브라우저에서 http://localhost:3000 주소로 접속하여 "Hello World!" 메시지를 확인할 수 있습니다. 이 메시지는 여러분의 Nest.js 애플리케이션이 정상적으로 작동하고 있음을 나타냅니다. 이후에는 다양한 라우팅 및 기능을 추가하여 애플리케이션을 확장해 나갈 수 있습니다.

5. IDE 및 코드 편집기 설정 (선택 사항)

개발 환경을 더욱 편하게 하기 위해 Visual Studio Code나 IntelliJ IDEA 같은 통합 개발 환경(IDE)을 사용하는 것을 추천합니다. 이러한 IDE는 코드 작성 시 생산성을 높여주며, 다양한 플러그인과 함께 사용할 수 있습니다.

  • Visual Studio Code는 다양한 확장 기능을 제공하며, JavaScript 및 TypeScript 지원이 뛰어나므로 많은 개발자들이 선호합니다. 코드 자동 완성, 디버깅 도구, Git 통합 등 다양한 기능이 있어 개발 효율성을 높여줍니다.
  • 코드 스타일이나 포맷팅 도구도 추가하면 코드 품질 향상에 도움이 됩니다. 예를 들어, Prettier와 ESLint를 사용하여 코드의 일관성을 유지하고, 오류를 사전에 방지할 수 있습니다.

요약

Nest.js의 설치 과정은 비교적 간단하며, Node.js와 npm만 있으면 시작할 수 있습니다. 다음은 설치 과정의 요약입니다:

  1. Node.js 및 npm 확인: 시스템에 설치되어 있는지 확인하고, 필요시 설치합니다.
  2. Nest CLI 전역으로 설치: Nest.js 프로젝트를 관리하기 위한 도구를 설치합니다.
  3. 새로운 프로젝트 생성: 원하는 이름으로 새로운 Nest.js 프로젝트를 생성합니다.
  4. 개발 서버 실행: 기본 애플리케이션을 실행하여 정상 작동 여부를 확인합니다.

위 단계를 따르면 첫 번째 Nest 앱을 손쉽게 만들어 볼 수 있으며, 이후에는 더 복잡한 기능들을 구현해 나갈 준비가 되어 있을 것입니다! Nest.js의 강력한 기능을 활용하여 여러분의 웹 애플리케이션 개발에 큰 도움이 되기를 바랍니다.

728x90