Node.js 설치
nodejs.org에서 Node.js LTS를 설치해 Next.js 실행에 필요한 20.9 이상 조건을 충족하고, node·npm 버전 확인과 함께 npm·npx의 역할까지 이해합니다.
핵심 요약
- Next.js 공식 설치 문서는 Node.js 20.9 이상을 요구하며, 최신 LTS를 설치하면 이 조건을 충족합니다(2026-05-14 기준 24.15.0 "Krypton").
- nodejs.org에서 Current가 아닌 LTS 버전의
.msi를 받아 기본값(Next)으로 설치합니다. - 설치 후 새 PowerShell에서
node --version과npm --version이 모두 버전 번호를 보이면 정상입니다. - 명령을 못 찾으면 PowerShell을 새로 열거나 재부팅하고, 버전이
v20.9.0미만이면 최신 LTS를 다시 설치합니다. - Node.js를 설치하면 라이브러리 관리 도구 npm과, 나중에 프로젝트 생성에 쓰는 npx가 함께 설치됩니다.
Node.js(노드제이에스)는 JavaScript를 컴퓨터에서 실행할 수 있게 해주는 환경입니다. Next.js 프로젝트를 만들고 실행하려면 Node.js가 필요합니다.
Node.js LTS 다운로드
Next.js 공식 설치 문서는 Node.js 20.9 이상을 요구합니다. 처음 설치한다면 최신 LTS를 선택하면 이 조건을 만족합니다.
공식 사이트 접속
웹 브라우저에서 nodejs.org에 접속합니다.
LTS 버전 다운로드
메인 페이지에 표시된 LTS(Long Term Support) 버전의 다운로드 버튼을 클릭합니다.
설치 실행
다운로드된 .msi 파일을 실행합니다. 설치 마법사가 나타나면 기본값(Next)을 그대로 유지하며 진행합니다.
설치 완료
Install 버튼을 클릭하고 설치가 완료될 때까지 기다립니다.
LTS vs Current
- LTS(추천): 안정적인 장기 지원 버전. 대부분의 프로젝트에 적합합니다. 2026-05-14 기준 최신 LTS는 24.15.0 "Krypton" 입니다
- Current: 최신 기능이 포함되어 있지만 불안정할 수 있습니다
처음 시작하신다면 반드시 LTS 버전을 선택하세요.
설치 확인
PowerShell을 새로 열고 아래 명령어를 각각 입력합니다:
node --versionv24.15.0npm --version버전 번호가 표시됨node와 npm 둘 다 버전 번호가 나오면 제대로 설치된 겁니다. 정확한 숫자는 설치 시점에 따라 달라집니다.
버전 기준
node --version이 v20.9.0보다 낮으면 Next.js 최신 버전을 실행할 수 없습니다. Node.js 공식 사이트에서 최신 LTS를 다시 설치하세요.
명령어를 찾을 수 없다고 나올 때
PowerShell을 닫고 새로 열어보세요. 설치 직후에는 환경 변수가 갱신되지 않아 기존 PowerShell 창에서는 인식되지 않을 수 있습니다. 새 PowerShell에서도 안 되면 컴퓨터를 재시작하세요.
npm이란?
Node.js를 설치하면 npm(Node Package Manager)이 함께 설치됩니다. npm은 다른 사람이 만든 코드 라이브러리를 쉽게 다운로드하고 관리하는 도구입니다.
나중에 Next.js 프로젝트를 만들 때 npx 명령어를 사용하게 되는데, 이것도 npm과 함께 설치됩니다.