icon안동민 개발노트

Node.js 및 npm 설치

 Next.js 개발을 시작하기 위해서는 먼저 Node.js와 npm(Node Package Manager)을 설치해야 합니다.

 이 절에서는 각 운영 체제별 설치 방법을 단계별로 안내하겠습니다.

Node.js와 npm이란?

  • Node.js : 서버 사이드 JavaScript 런타임 환경입니다.
  • npm : Node.js와 함께 자동으로 설치되는 패키지 관리자입니다.

운영 체제별 설치 방법

 Windows

  1. Node.js 공식 웹사이트에 접속합니다.
  2. LTS(Long Term Support) 버전 다운로드 버튼을 클릭합니다.
  3. 다운로드된 설치 파일(.msi)을 실행합니다.
  4. 설치 마법사의 지시에 따라 설치를 진행합니다.

 macOS

  1. Homebrew를 사용하는 경우
brew install node
  1. 직접 설치하는 경우

 Linux (Ubuntu/Debian)

  1. 터미널을 열고 다음 명령어를 순서대로 실행합니다.
sudo apt update
sudo apt install nodejs npm

설치 확인

 설치가 완료되면 터미널(또는 명령 프롬프트)에서 다음 명령어를 실행하여 버전을 확인합니다.

node --version
npm --version

 각 명령어 실행 후 버전 번호가 출력되면 설치가 성공적으로 완료된 것입니다.

버전 관리

 Node.js와 npm의 버전을 최신으로 유지하는 것이 좋습니다.

 운영체제별 업데이트 방법은 다음과 같습니다.

  • Windows/macOS : 새 버전의 설치 파일을 다운로드하여 설치합니다.
  • Linux
sudo apt update
sudo apt upgrade nodejs npm

nvm (Node Version Manager)

 여러 버전의 Node.js를 관리해야 하는 경우, nvm 사용을 고려해보세요. nvm을 통해 프로젝트별로 다른 Node.js 버전을 쉽게 사용할 수 있습니다.

Next.js 프로젝트 생성과의 연결

 Node.js와 npm이 성공적으로 설치되면, 다음 섹션에서 이를 사용하여 Next.js 프로젝트를 생성하게 됩니다. npm을 통해 Next.js와 관련 패키지들을 설치하고 관리하게 될 것입니다.

설치 체크리스트

  • Node.js가 성공적으로 설치되었습니까? (node --version 명령어로 확인)
  • npm이 성공적으로 설치되었습니까? (npm --version 명령어로 확인)
  • 설치된 Node.js 버전이 Next.js 14의 요구사항을 충족합니까? (18.18.0 이상)
  • 터미널(또는 명령 프롬프트)에서 node와 npm 명령어가 인식됩니까?
  • (선택사항) nvm을 설치하였습니까?

 모든 항목에 체크할 수 있다면, Next.js 개발을 위한 기본 환경 설정이 완료된 것입니다.

학습 목표 및 전제 조건Next.js 14 프로젝트 생성