icon
2장 : 개발 환경 설정

node.js 및 npm 설치

본격적으로 Next.js 개발을 시작하기에 앞서, 가장 먼저 해야 할 일은 개발 환경을 구축하는 것입니다. Next.js는 Node.js 런타임 환경 위에서 동작하며, 프로젝트 관리를 위해 npm(Node Package Manager) 또는 Yarn과 같은 패키지 매니저를 사용합니다. 따라서, 이 두 가지 도구를 여러분의 시스템에 설치하는 것이 첫걸음입니다.

이 절에서는 Node.js와 npm을 설치하는 가장 일반적이고 권장되는 방법에 대해 상세히 안내해 드리겠습니다. 이미 설치되어 있다면 버전을 확인하고 최신 상태로 유지하는 방법을 살펴보겠습니다.


Node.js와 npm이란 무엇인가요?

  • Node.js: 웹 브라우저 밖에서 JavaScript 코드를 실행할 수 있도록 하는 런타임 환경입니다. Next.js는 서버 사이드 렌더링(SSR)이나 API 라우트와 같은 기능을 위해 Node.js 환경을 필요로 합니다.
  • npm (Node Package Manager): Node.js 생태계의 표준 패키지 매니저입니다. npm을 사용하면 Next.js 프로젝트에 필요한 다양한 라이브러리(패키지)를 쉽게 설치하고 관리할 수 있습니다. Node.js를 설치하면 npm은 자동으로 함께 설치됩니다.

Node.js 및 npm 설치하기

Node.js를 설치하는 가장 쉽고 권장되는 방법은 공식 웹사이트에서 제공하는 설치 관리자(Installer)를 사용하는 것입니다.

  1. Node.js 공식 웹사이트 방문 먼저 웹 브라우저를 열고 Node.js 공식 웹사이트(https://nodejs.org/ko)에 접속합니다. 대부분의 사용자에게는 "LTS (Long Term Support)" 버전을 다운로드하는 것이 권장됩니다. LTS 버전은 장기적인 지원을 약속하며 안정성이 검증된 버전입니다. 최신 기능이 필요하다면 "Current" 버전을 선택할 수도 있지만, 안정성을 위해 LTS 버전을 우선적으로 고려하는 것이 좋습니다.

  2. 설치 관리자 실행 다운로드한 파일을 실행하고, 화면의 지시에 따라 설치를 진행합니다. 대부분의 경우 특별한 설정을 변경할 필요 없이 "Next" 버튼을 클릭하여 기본 옵션으로 설치를 완료할 수 있습니다. 설치 과정에서 npm package manager 옵션이 체크되어 있는지 확인하세요. (일반적으로 기본으로 체크되어 있습니다.)

    • Windows 사용자: .msi 파일을 다운로드하여 실행합니다.
    • macOS 사용자: .pkg 파일을 다운로드하여 실행합니다.
    • Linux 사용자: 공식 웹사이트의 가이드를 참조하거나, 배포판의 패키지 관리자를 이용할 수 있습니다. (예: sudo apt install nodejs npm for Ubuntu)

설치 확인 및 버전 업데이트

설치가 완료되었다면, 터미널(Windows의 경우 명령 프롬프트 또는 PowerShell, macOS/Linux의 경우 터미널 앱)을 열어 Node.js와 npm이 제대로 설치되었는지 확인합니다.

  1. Node.js 버전 확인 터미널에 다음 명령어를 입력하고 Enter 키를 누릅니다.

    node -v

    명령어를 실행하면 vXX.XX.X와 같이 설치된 Node.js의 버전이 출력될 것입니다. 예를 들어, v20.11.1과 같이 나타날 수 있습니다.

  2. npm 버전 확인 이어서 npm의 버전도 확인해 보세요.

    npm -v

    마찬가지로 X.X.X와 같은 형식으로 npm 버전이 출력될 것입니다.

  3. npm 최신 버전 유지 (선택 사항) npm은 Node.js와 함께 설치되지만, npm 자체도 독립적으로 업데이트될 수 있습니다. 때때로 최신 버전의 npm이 더 나은 성능이나 새로운 기능을 제공하므로, npm을 최신 상태로 유지하는 것이 좋습니다. 다음 명령어를 사용하여 npm을 최신 버전으로 업데이트할 수 있습니다.

    npm install -g npm@latest

    -g 옵션은 npm을 전역(global)으로 설치하여 어떤 프로젝트에서도 사용할 수 있도록 합니다.


Node.js 버전 관리 (선택 사항: NVM)

여러 버전의 Node.js를 사용해야 하는 경우가 발생할 수 있습니다. 예를 들어, 어떤 프로젝트는 특정 Node.js 버전을 요구하고, 또 다른 프로젝트는 최신 버전을 사용해야 할 때 유용합니다. 이런 경우 NVM(Node Version Manager) 을 사용하면 편리하게 Node.js 버전을 전환할 수 있습니다. NVM 설치 및 사용법은 이 책의 범위를 약간 벗어나지만, 필요하다면 검색 엔진에서 "NVM 설치"를 검색하여 별도로 학습해 보시는 것을 권장합니다.

이제 여러분의 시스템에 Next.js 개발을 위한 기본적인 환경인 Node.js와 npm이 성공적으로 설치되었습니다.