웹 개발을 시작할 때 가장 먼저 설치하게 되는 도구 중 하나가 바로 Node.js입니다. 자바스크립트를 브라우저가 아닌 곳에서도 사용할 수 있게 만들어주는 런타임 환경으로, React, Vue, Next.js 등 다양한 프레임워크의 기반이 되기도 하죠.
하지만 처음 설치할 때 어떤 버전을 골라야 하는지, 설치 후 어떤 설정을 해야 하는지 헷갈리는 분들이 많습니다. 특히 LTS(Long Term Support) 버전 선택과 환경변수 등록은 필수입니다.
이 글에서는 Node.js LTS 버전 설치 방법과 환경변수 등록까지 차근차근 설명드릴게요. Windows 사용자 기준으로 작성했으며, Mac 사용자는 참고용으로 보셔도 좋습니다.

이 글은 이런 분들에게 추천합니다
- Node.js를 처음 설치하는 웹 개발 입문자
- React, Vue, Express를 설치하기 전 사전 세팅이 필요한 분
- 환경변수 개념이 어렵게 느껴지는 분
- Windows 환경에서 Node.js를 안정적으로 설치하고 싶은 분
LTS 버전이란 무엇인가요?
Node.js는 다양한 버전이 존재하지만, 웹 개발 입문자와 실무 개발자 대부분은 LTS (Long Term Support) 버전을 사용합니다.
- LTS 버전: 장기 지원 버전으로, 안정성과 호환성이 높아 권장됨
- Current 버전: 최신 기능을 포함하나, 변경이 많고 실험적인 버전
따라서 실무 프로젝트나 학습용 프로젝트를 시작할 때는 반드시 LTS 버전을 선택해 설치하는 것이 좋습니다.
Node.js LTS 버전 설치 파일 다운로드
Node.js 공식 사이트에서 LTS 버전 설치 파일을 바로 다운로드할 수 있습니다. Windows, Mac, Linux 모두 지원합니다.
👉 Node.js 공식 다운로드 페이지에서 LTS 버전 설치 파일 받기
- 위 링크에 접속한 후, ‘LTS’로 표시된 버전을 선택하세요.
- Windows 사용자는 ‘.msi’ 파일을 다운로드하세요 (예: node-v18.x.x-x64.msi)
- 설치 파일을 실행한 뒤, Next → Next → Install을 눌러 설치를 진행합니다.
설치 중 옵션에서 npm, 추가 PATH 설정, 자동 업데이트, Chocolatey 설치 항목이 보일 수 있는데, 기본값 그대로 설치해도 문제 없습니다.
설치 확인 및 버전 체크
설치가 끝났다면, 명령 프롬프트(CMD)나 PowerShell을 열고 다음 명령어를 입력해보세요.
node -v
npm -v
이렇게 하면 Node.js와 npm(Node Package Manager)의 설치 버전이 출력되어야 합니다.
v18.19.0
9.8.1
버전이 정상적으로 출력된다면 설치가 잘 완료된 것입니다!
환경변수 등록 확인 및 수정 방법
일반적으로 `.msi` 설치 파일을 통해 설치하면 환경변수가 자동으로 등록됩니다. 하지만 특정 상황(수동 설치, 폴더 이동 등)에서는 수동으로 환경변수를 설정해야 할 수도 있습니다.
환경변수 확인
- Windows 검색창에 ‘환경 변수 편집’ 입력 → 실행
- ‘시스템 속성’ → ‘환경 변수(N)’ 클릭
- ‘시스템 변수’ 또는 ‘사용자 변수’ 중 Path 선택 → 편집
- Node.js 설치 경로가 있는지 확인 (예:
C:\Program Files\nodejs\
)
수동으로 등록할 경우
- ‘새로 만들기’ 클릭 후 Node.js 설치 폴더 경로를 입력
- 확인 → 확인 → 시스템 재시작 또는 CMD 재실행
이 과정을 거치면 전역에서 node
와 npm
명령어를 사용할 수 있게 됩니다.
Node.js로 “Hello World” 실행해보기
설치 확인도 끝났으니, 간단한 자바스크립트 코드를 실행해볼까요?
- 메모장을 열고 아래와 같이 입력합니다:
console.log('Hello, Node.js!');
- 이 파일을
hello.js
로 저장합니다. - CMD에서 해당 파일이 있는 경로로 이동 후 아래 명령 실행:
node hello.js
정상적으로 출력되면 Node.js가 제대로 작동하는 것입니다.
npm으로 패키지 설치해보기
Node.js를 설치하면 자동으로 npm(Node Package Manager)도 함께 설치됩니다. 다음 명령어로 로컬 패키지를 설치해보세요.
npm install cowsay
그리고 나서 아래와 같이 실행해보면:
npx cowsay "Node.js 설치 완료!"
귀여운 소가 텍스트를 말하는 ASCII 아트가 출력됩니다. 재미있으면서도, CLI 환경을 익히기에 좋은 예제죠.
자주 발생하는 설치 오류 해결 팁
- 설치 후
node
명령이 안 되는 경우 → 환경변수 누락 여부 확인 - 권한 문제로 설치 실패 → 관리자 권한으로 설치 파일 실행
- 이전 버전이 충돌하는 경우 → 프로그램 추가/제거에서 완전히 삭제 후 재설치
그래도 해결되지 않는다면 이전 버전 아카이브 페이지에서 안정적인 버전을 수동으로 설치해보는 것도 좋은 방법입니다.
Node.js 설치는 웹 개발의 시작
Node.js는 단순한 자바스크립트 실행 환경을 넘어서서 모던 웹 개발의 중심입니다. React, Vue, Next.js, Express… 이 모든 생태계의 기반이 되는 필수 도구이기 때문에, 제대로 설치하고 환경을 구성하는 게 매우 중요하죠.
지금 바로 Node.js LTS 버전을 설치하고 웹 개발 여정을 시작해보세요