Node.js 설치 가이드 - 바이브코딩

📚 개발 환경 세팅 완벽 가이드 시리즈

1편부터 순서대로 따라하세요!

⬅️ 이전: Git 설치하기 | ➡️ 다음: VS Code 설치하기

🚀 Node.js가 왜 필요한가요?

사실 처음에 "왜 Node.js를 설치해야 하지?" 생각했었어요.

그런데 개발하다 보니까 이게 없으면 정말 아무것도 안 되더라고요.

🔍 개발하시는 분들이라면 이런 상황 겪어보셨을 거예요

프로젝트 생성하려고 하는데 "npm이 뭐지?" 하면서 막히고
패키지 설치하라고 하는데 명령어가 안 먹히고
개발 도구들 설치하려고 하는데 "Node.js가 필요합니다" 메시지만 보고

Node.js는 JavaScript로 서버나 도구를 만들 수 있게 해주는 런타임이에요. 그리고 npm이라는 패키지 관리자가 같이 딸려와서 각종 개발 도구들을 쉽게 설치할 수 있게 해줍니다.

💻 운영체제별 Node.js 설치

🪟 Windows 사용자

직접 다운로드 링크: https://nodejs.org/dist/v22.18.0/node-v22.18.0-x64.msi

설치 방법:

위 링크 클릭해서 파일 다운로드
다운로드된 .msi 파일 실행

설치 과정에서 모든 옵션을 기본값으로 유지
"Next" 계속 클릭하여 설치 진행
"Install" 클릭하여 설치 완료

주의사항:

"Automatically install the necessary tools" 체크박스가 나오면 체크 해제 권장 (불필요한 도구들 설치 방지)
관리자 권한 요청이 나오면 "예" 클릭

🍎 Mac 사용자

다운로드: https://nodejs.org/dist/v22.18.0/node-v22.18.0.pkg

설치 방법:

위 링크 클릭해서 pkg 파일 다운로드
다운로드된 파일 실행하여 설치
기본값으로 설치 진행

🐧 Ubuntu/Linux 사용자

터미널에서 명령어 실행:

# NodeSource 저장소 추가
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# Node.js 설치
sudo apt-get install -y nodejs

✅ 설치 확인하기

터미널을 열고 다음 명령어들을 입력해보세요:

node -v
npm -v

성공 시 나타나는 화면:

정상적으로 설치되었다면:

node -v: v22.18.0 (또는 유사한 버전)
npm -v: 10.x.x (버전은 다를 수 있음)

🔧 Node.js로 할 수 있는 것들

실제로 경험해보니:

프로젝트 생성: npx create-next-app, npx create-react-app 등
패키지 설치: 필요한 라이브러리들을 npm install로 쉽게 설치
개발 도구: Gemini CLI, VS Code 확장프로그램들 설치 가능
빌드 도구: 프로젝트 빌드하고 배포하는 도구들 실행

솔직히 처음엔 "이게 뭐하는 거지?" 싶었는데, 막상 써보니까 개발할 때 없으면 안 되는 필수 도구더라고요.

❗ 문제 해결

"node를 인식할 수 없습니다" 오류 시:

Windows:

컴퓨터 재시작
터미널을 관리자 권한으로 실행
환경변수 PATH에 Node.js 경로가 추가되었는지 확인

명령 프롬프트에서 확인:

echo %PATH%

Mac/Linux:

터미널 재시작
which node 명령어로 설치 경로 확인

권한 문제가 발생할 때:

Windows:

터미널을 관리자 권한으로 실행

Mac/Linux:

# npm 글로벌 패키지 권한 설정
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

🚀 다음 단계 미리보기

Node.js 설치가 완료되었다면 다음은 VS Code 설치입니다.

VS Code에서 이런 것들을 할 수 있어요:

Node.js 프로젝트 개발
터미널 통합 사용
각종 확장프로그램으로 개발 효율성 극대화

다음 글에서 만나요: VS Code 설치하기

💡 시리즈 완주하면 이런 걸 할 수 있어요

✅ Git: 코드 버전 관리
✅ Node.js: JavaScript 개발 환경
VS Code: 전문 개발자급 코딩 환경
GitHub: 포트폴리오 코드 저장 및 공유
Vercel: 포트폴리오 배포 및 호스팅
Gemini CLI: AI와 함께 코딩하기

차근차근 따라오시면 어느새 개발 환경 세팅 마스터가 되실 거예요!

Node.js 설치 가이드 - JavaScript 개발 필수 환경 세팅