다운가이드
개발·네트워크

Node.js 다운로드 · JavaScript 실행 환경 확인

Node.js · Node.js 프로젝트 / OpenJS Foundation

브라우저 밖에서 JavaScript와 웹 개발 도구를 실행합니다.

지원 운영체제Windows · macOS · Linux
라이선스MIT 라이선스 중심의 오픈 소스. 포함된 구성 요소에는 별도 고지가 적용됩니다.
공식 링크 확인2026-11-01
이 페이지에서

프로그램 소개

웹 앱의 개발 서버나 명령줄 도구를 실행할 때 사용하는 JavaScript 런타임입니다. 프로그램을 시작하기 전에 프로젝트가 요구하는 Node.js 버전 범위를 확인하면 호환성 문제를 줄일 수 있습니다. LTS와 Current 채널의 목적은 서로 다르므로 운영 중인 프로젝트의 요구사항에 맞춰 선택하세요.

주요 기능

  • JavaScript 명령줄 실행
  • npm 기반 개발 도구 사용
  • 네트워크 서버와 파일 처리

다운로드 및 설치

  1. 프로젝트의 package.json이나 개발 문서에서 필요한 런타임 범위를 확인한 뒤 공식 페이지에서 호환되는 지원 채널을 고릅니다.
  2. Windows는 아키텍처에 맞는 Installer를, Mac은 제공되는 패키지를 선택합니다. Linux는 공식 페이지의 배포 방식별 관리 주체를 확인합니다.
  3. 설치가 끝나면 새 터미널에서 node --version과 npm --version을 각각 확인합니다.
  4. 연습용 폴더에서 node -e "console.log(1 + 1)"을 실행해 2가 표시되는지 확인한 뒤 프로젝트 설치 명령을 실행합니다.

Node.js와 npm이 실행되는지 확인

설치 후 새 터미널에서 node --version과 npm --version을 각각 실행합니다. 두 버전이 표시되면 해당 터미널에서 실행 환경과 패키지 관리자를 찾은 것입니다. 명령을 인식하지 못하면 설치 전에 열어 둔 창을 닫고 새 창에서 재확인하세요. node는 실행되지만 npm.ps1에 대한 정책 오류가 나오면 런타임 미설치와 구분해 오류에 나온 파일과 실행 방법을 확인합니다.

node --version
npm --version

JavaScript 파일을 직접 실행해 보기

연습용 폴더에 hello.js를 만들고 console.log("Hello Node.js");를 저장합니다. 터미널을 그 폴더로 옮긴 뒤 아래 명령을 실행하면 출력 줄이 표시되고 종료됩니다. 파일을 찾을 수 없다는 메시지가 나오면 현재 폴더와 확장자를 확인하세요. Node.js에서 파일이 실행돼도 브라우저의 document 같은 DOM 기능이 그대로 제공되는 것은 아닙니다.

node hello.js

사용 팁과 확인 사항

  • 기존 프로젝트에 설치하기 전 engines 항목과 잠금 파일이 사용하는 패키지 관리자를 확인하세요.
  • 런타임을 바꾼 후 터미널에 이전 버전이 나오면 여러 설치가 PATH에 함께 있는지 확인합니다.
  • 모르는 프로젝트에서 npm install을 실행하면 설치 스크립트가 동작할 수 있으므로 프로젝트 출처와 명령을 먼저 읽습니다.

설치·오류 해결 문서

Windows · 입문 · 8개 항목VS Code 설치와 한국어 메뉴 설정

내 계정에 편집기를 설치한 다음 메뉴를 한국어로 바꾸고, 작업 폴더에서 편집기를 여는 방법을 확인합니다.

Windows · 입문 · 7개 항목VS Code 설치 후 code 명령을 찾을 수 없을 때

시작 메뉴에서 편집기는 열리지만 PowerShell이나 명령 프롬프트에서 code를 인식하지 못하는 경우를 다룹니다.

Windows · 입문 · 8개 항목Windows에 Git 설치하고 작성자 정보 설정하기

Git Bash에서 설치 상태를 확인하고 커밋에 남길 이름과 이메일이 어느 저장소에 적용되는지 점검합니다.

Windows · 입문 · 7개 항목Git 설치 후 PowerShell에서 git을 인식하지 못할 때

git 명령어 인식 오류가 나면 Git 설치 자체와 현재 셸의 PATH 설정을 구분해 점검합니다.

Windows · 기본 · 7개 항목Windows에 Python 설치하고 프로젝트 가상환경 만들기

Python 실행 상태를 확인한 뒤 프로젝트 전용 환경을 만들고, 활성화 없이도 올바른 환경의 패키지를 확인하는 순서입니다.

Windows · 기본 · 6개 항목Node.js 설치 후 node 또는 npm 명령이 인식되지 않을 때

런타임 미설치, 이전 터미널 환경, 여러 설치 경로와 PowerShell의 스크립트 제한을 구분해서 확인합니다.

함께 살펴볼 프로그램

  • 비주얼 스튜디오 코드 · 코드 편집, 터미널, Git 변경 사항 확인을 한 창에서 처리합니다.
  • 파이썬 · 자동화 스크립트와 데이터 처리 프로그램을 실행하는 언어 환경입니다.
  • 깃 · 파일을 수정한 기록을 커밋으로 남기고 브랜치별로 작업합니다.

공식 출처

최초 등록 2026-11-01 · 내용 수정 2026-11-01 · 공식 링크 확인 2026-11-01