[개발환경 기초] Node.js란? 초코라떼로 이해하는 설치방법 + 버전 체크 안 될 때 환경변수 설정까지

안녕하세요!

오늘은 개발 공부를 시작하거나 바이브코딩으로 뭔가 만들어보려다 보면 꼭 한 번은 마주치게 되는 이름, Node.js에 대해 정리할께요.

솔직히 처음에 "Node.js 설치하세요" 소리를 들었을 때 

아 이 작업에 이게 필요하니까 설치하라는건가? 하고 그냥 클릭클릭 대충 설치했어요. 

근데 설치하고 나서 터미널에 node -v 쳤는데 아무것도 안 나오는 경험... 다들 한 번씩 있죠? 

(전 많아요... 왜 많지?... 머 할때마다 찾음 없다고 나옴.....😡)

이 글에서는 Node.js가 뭔지, 설치는 어떻게 하는지, 그리고 설치했는데 버전 체크가 안 될 때 어떻게 해결하는지까지 한 번에 정리해드릴게요.

Node.js란? 초코라떼로 이해하는 설치방법 + 버전 체크 안 될 때 환경변수 설정

1. Node.js가 뭔지, 진짜 쉽게 설명하면

Node.js는 한 마디로 이렇게 설명할 수 있어요.

"JavaScript를 브라우저 밖에서도 실행할 수 있게 해주는 환경"

 

원래 JavaScript는 웹 브라우저 안에서만 돌아가는 언어였어요. 크롬이나 엣지 같은 브라우저가 JS를 읽고 실행해줬던 거예요.

근데 Node.js가 등장하면서 상황이 바뀌었어요. 이제 JavaScript를 내 컴퓨터에서, 서버에서, 어디서든 실행할 수 있게 됐어요.

비유를 하나 들어볼게요.

초코라떼 파우더가 있어요. 원래 이 파우더는 카페에서만 (브라우저에서만) 뜨거운 물에 타서 마실 수 있었어요. 근데 Node.js가 생기면서 집에서도, 사무실에서도, 캠핑장에서도 (어디서든) 같은 파우더로 라떼를 만들 수 있게 됐어요.

파우더(JavaScript)는 똑같아요. 마실 수 있는 환경이 훨씬 넓어진 것뿐이에요.

그래서 Node.js를 쓰면 이런 게 가능해집니다.

• JavaScript로 서버 만들기
• JavaScript로 파일 읽고 쓰기
• npm(패키지 관리자)을 통해 수만 가지 라이브러리 사용하기
• React, Flutter 개발할 때 필요한 빌드 도구 실행하기

마지막 게 사실 초보자한테 제일 중요해요. React 개발하려면 Node.js 설치 필수거든요. 

Cursor AI로 뭔가 만들어달라고 하면 거의 항상 Node.js가 필요합니다.

2. npm이 뭔지도 같이 알아두자

Node.js 얘기 나오면 항상 따라오는 게 npm이에요.

npm (Node Package Manager) = Node.js랑 같이 설치되는 패키지 관리자예요.

패키지는 쉽게 말해 남이 만들어둔 코드 묶음이에요. 내가 직접 만들 필요 없이 "npm으로 설치하면" 바로 쓸 수 있는 도구들이에요.

초코라떼 비유로 다시 설명하면.

초코라떼를 만들 때 파우더만 있으면 안 되잖아요. 우유도 필요하고, 시럽도 필요하고, 컵도 필요하죠.

npm은 "저 우유 가져다 줄게요, 시럽도 가져다 줄게요" 하는 편의점 같은 역할이에요. 내가 필요한 재료(패키지)를 검색하고 가져다 쓸 수 있는 공간이 npm입니다.

실제로 이렇게 씁니다.

npm install react       # React 설치
npm install axios       # axios (API 요청 도구) 설치
npm run dev             # 개발 서버 실행

Cursor로 바이브코딩 하다 보면 이런 명령어들이 자동으로 나오는데, 이제 보이면 "아, npm으로 뭔가 설치하거나 실행하는 거구나" 하고 읽힐 거예요.

3. Node.js 설치방법 — 생각보다 훨씬 간단해요

1단계: 공식 사이트 접속

nodejs.org 에 접속합니다.

메인 화면에 버튼 두 개가 바로 보여요.

• LTS (Long Term Support) — 안정 버전, 이걸 설치하세요
• Current — 최신 기능 버전, 초보자한테는 LTS가 낫습니다

★ LTS를 고르는 이유: 안정적이고 오래 지원되는 버전이에요. 새로운 기능보다 안정성이 중요한 개발 환경용으로는 LTS가 정답입니다.

 

2단계: 설치 파일 다운로드 & 실행

Windows 기준으로 .msi 파일이 다운로드돼요. 

실행하면 설치 마법사가 나오는데, 그냥 Next → Next → Install 눌러서 완료하면 됩니다.

중간에 "Add to PATH" 옵션이 있으면 반드시 체크하세요. 이게 나중에 중요합니다.

3단계: 설치 확인

설치가 끝나면 PowerShell(또는 터미널)을 열고 입력 

node -v
npm -v

이렇게 버전 숫자가 뜨면 설치 성공입니다.

v20.11.0
10.2.4

4. 버전 체크가 안 될 때 — 환경변수 설정하는 법

설치는 했는데 node -v 쳤더니 이런 게 나왔다면...

'node'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는
배치 파일이 아닙니다.

당황하지 마세요. 이건 설치가 안 된 게 아니에요. 

컴퓨터가 node가 어디 있는지 모르는 것뿐이에요.

다시 초코라떼 비유로 설명하면

파우더를 사서 집에 가져왔어요. 

근데 주방 어느 서랍에 넣었는지 잊어버린 거예요. 

라떼를 만들려고 찾는데 "파우더 없는데요?" 소리 나오는 상황이에요.

서랍 위치(경로)를 컴퓨터한테 알려줘야 해요. 그게 환경변수 설정입니다.

Windows에서 환경변수 설정하는 법

① Node.js 설치 경로 확인

PowerShell을 열고

where node

보통 이런 경로가 나와요. 

C:\Program Files\nodejs\node.exe




경로가 나오면 C:\Program Files\nodejs 부분을 복사해두세요.

② 환경변수 창 열기

Windows 검색창에 "환경 변수" 검색 → "시스템 환경 변수 편집" 클릭

또는 단축키: Win + R → sysdm.cpl 입력 → 고급 탭 → 환경 변수 버튼

③ Path에 추가

아래쪽 "시스템 변수" 목록에서 Path 찾아서 더블클릭

→ 새로 만들기 클릭

→ 아까 복사해둔 경로 붙여넣기  C:\Program Files\nodejs

→ 확인 → 확인 → 확인

④ PowerShell 완전히 닫고 다시 열기

이게 중요해요. 환경변수는 터미널을 새로 열어야 적용됩니다. 

열려있던 PowerShell 다 닫고, 새로 열어서 다시 node -v 입력해보세요.

이제 버전 숫자가 뜰 거예요.

그래도 안 된다면? — 재설치 추천

위 방법을 했는데도 안 된다면 한 번 깔끔하게 재설치하는 게 빠릅니다.

1. 제어판 → 프로그램 추가/제거 → Node.js 제거
2. C:\Program Files\nodejs 폴더 남아있으면 삭제
3. nodejs.org에서 다시 다운로드 → 설치
4. 이번엔 설치 중간에 "Add to PATH" 체크 확인
5. PowerShell 새로 열고 node -v 확인

5. Node.js 버전 여러 개 관리하려면 — nvm 소개

개발을 좀 하다 보면 프로젝트마다 필요한 Node.js 버전이 달라요. 

A 프로젝트는 Node 18 필요하고, B 프로젝트는 Node 20 필요하고...

이럴 때 쓰는 도구가 nvm (Node Version Manager) 입니다.

nvm install 20      # Node 20 설치
nvm use 18          # Node 18로 전환
nvm list            # 설치된 버전 목록 확인

당장 필요하진 않지만, 나중에 여러 프로젝트 동시에 관리할 때 알아두면 편해요.

Windows용은 nvm-windows, 

Mac/Linux는 nvm 검색하면 바로 나옵니다.

6. 바이브코딩할 때 Node.js가 왜 필요한지

Cursor AI로 개발할 때 Node.js가 필요한 상황을 정리해볼게요.

React / Next.js 프로젝트 만들 때

npx create-react-app my-app
npx create-next-app my-app

이런 명령어들이 전부 Node.js 기반이에요. Node.js 없으면 실행 자체가 안 됩니다.

★npm vs npx ???

npm은 패키지를 설치할 때, npx는 설치 없이 바로 실행할 때 써요. 

프로젝트 생성은 한 번만 쓰는 명령어라 npx가 맞아요!

패키지 설치할 때 AI가 "이 라이브러리 설치해서 써요" 하면서 npm install 뭔가 명령어를 알려주는데, npm이 Node.js랑 같이 설치되어 있어야 써요.

개발 서버 실행할 때

npm run dev
npm start

이런 거 실행할 때도 Node.js가 깔려있어야 합니다.

즉, JavaScript 계열 프로젝트를 바이브코딩으로 만들 거라면 Node.js는 필수 설치 항목이에요.

정리 — Node.js, 이것만 기억하면 됩니다

처음에 "Node.js가 뭔지도 모르는데 설치해야 하나요?" 싶을 수 있어요.

근데 솔직히 Node.js는 개발 환경을 세팅하는 기초 공사 같은 거예요. 한 번만 제대로 설치해두면 계속 쓰이는 것들이거든요.

오늘 정리한 내용만 기억하면 됩니다.

• Node.js = JavaScript를 브라우저 밖에서 실행할 수 있는 환경
• npm = Node.js랑 같이 설치되는 패키지(라이브러리) 관리자
• 설치 = nodejs.org → LTS 버전 다운로드 → Next Next Install
• 버전 체크 안 될 때 = 환경변수 Path에 Node.js 경로 추가 → 터미널 재시작
• 그래도 안 되면 = 제거 후 재설치, 이번엔 "Add to PATH" 꼭 체크

열공하세요! 🙌