Node.js 다운로드 · JavaScript 실행 환경 확인
브라우저 밖에서 JavaScript와 웹 개발 도구를 실행합니다.
이 페이지에서
프로그램 소개
웹 앱의 개발 서버나 명령줄 도구를 실행할 때 사용하는 JavaScript 런타임입니다. 프로그램을 시작하기 전에 프로젝트가 요구하는 Node.js 버전 범위를 확인하면 호환성 문제를 줄일 수 있습니다. LTS와 Current 채널의 목적은 서로 다르므로 운영 중인 프로젝트의 요구사항에 맞춰 선택하세요.
주요 기능
- JavaScript 명령줄 실행
- npm 기반 개발 도구 사용
- 네트워크 서버와 파일 처리
다운로드 및 설치
- 프로젝트의 package.json이나 개발 문서에서 필요한 런타임 범위를 확인한 뒤 공식 페이지에서 호환되는 지원 채널을 고릅니다.
- Windows는 아키텍처에 맞는 Installer를, Mac은 제공되는 패키지를 선택합니다. Linux는 공식 페이지의 배포 방식별 관리 주체를 확인합니다.
- 설치가 끝나면 새 터미널에서 node --version과 npm --version을 각각 확인합니다.
- 연습용 폴더에서 node -e "console.log(1 + 1)"을 실행해 2가 표시되는지 확인한 뒤 프로젝트 설치 명령을 실행합니다.
Node.js와 npm이 실행되는지 확인
설치 후 새 터미널에서 node --version과 npm --version을 각각 실행합니다. 두 버전이 표시되면 해당 터미널에서 실행 환경과 패키지 관리자를 찾은 것입니다. 명령을 인식하지 못하면 설치 전에 열어 둔 창을 닫고 새 창에서 재확인하세요. node는 실행되지만 npm.ps1에 대한 정책 오류가 나오면 런타임 미설치와 구분해 오류에 나온 파일과 실행 방법을 확인합니다.
node --version
npm --versionJavaScript 파일을 직접 실행해 보기
연습용 폴더에 hello.js를 만들고 console.log("Hello Node.js");를 저장합니다. 터미널을 그 폴더로 옮긴 뒤 아래 명령을 실행하면 출력 줄이 표시되고 종료됩니다. 파일을 찾을 수 없다는 메시지가 나오면 현재 폴더와 확장자를 확인하세요. Node.js에서 파일이 실행돼도 브라우저의 document 같은 DOM 기능이 그대로 제공되는 것은 아닙니다.
node hello.js사용 팁과 확인 사항
- 기존 프로젝트에 설치하기 전 engines 항목과 잠금 파일이 사용하는 패키지 관리자를 확인하세요.
- 런타임을 바꾼 후 터미널에 이전 버전이 나오면 여러 설치가 PATH에 함께 있는지 확인합니다.
- 모르는 프로젝트에서 npm install을 실행하면 설치 스크립트가 동작할 수 있으므로 프로젝트 출처와 명령을 먼저 읽습니다.
설치·오류 해결 문서
내 계정에 편집기를 설치한 다음 메뉴를 한국어로 바꾸고, 작업 폴더에서 편집기를 여는 방법을 확인합니다.
시작 메뉴에서 편집기는 열리지만 PowerShell이나 명령 프롬프트에서 code를 인식하지 못하는 경우를 다룹니다.
Git Bash에서 설치 상태를 확인하고 커밋에 남길 이름과 이메일이 어느 저장소에 적용되는지 점검합니다.
git 명령어 인식 오류가 나면 Git 설치 자체와 현재 셸의 PATH 설정을 구분해 점검합니다.
Python 실행 상태를 확인한 뒤 프로젝트 전용 환경을 만들고, 활성화 없이도 올바른 환경의 패키지를 확인하는 순서입니다.
런타임 미설치, 이전 터미널 환경, 여러 설치 경로와 PowerShell의 스크립트 제한을 구분해서 확인합니다.
함께 살펴볼 프로그램
- 비주얼 스튜디오 코드 · 코드 편집, 터미널, Git 변경 사항 확인을 한 창에서 처리합니다.
- 파이썬 · 자동화 스크립트와 데이터 처리 프로그램을 실행하는 언어 환경입니다.
- 깃 · 파일을 수정한 기록을 커밋으로 남기고 브랜치별로 작업합니다.