Node.js와 npm 설치

Lesson 3

Node.js는 JavaScript를 브라우저 밖에서 실행할 수 있게 해주는 런타임입니다. npm은 Node.js와 함께 설치되는 패키지 매니저 — 남이 만든 코드를 내 프로젝트에 쉽게 가져다 쓸 수 있습니다.

설치 방법

방법 1 — 공식 사이트에서 직접 설치 (입문자 추천)

nodejs.org → LTS 버전 다운로드 → 설치

LTS(Long Term Support)가 안정적인 버전입니다. Current는 최신이지만 불안정할 수 있습니다.

방법 2 — nvm으로 설치 (버전 관리 가능)

# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 터미널 재시작 후
nvm install --lts
nvm use --lts

설치 확인

node --version   # v20.x.x 같은 숫자가 나오면 성공
npm --version    # 10.x.x 같은 숫자가 나오면 성공

npm으로 하는 일

npm install              # package.json의 모든 패키지 설치
npm install gsap         # gsap 패키지 하나만 설치
npm uninstall gsap       # 패키지 삭제
npm run dev              # 개발 서버 실행
npm run build            # 배포용 빌드 생성
npm init -y              # 새 package.json 생성 (질문 없이)

package.json 이해하기

모든 Node 프로젝트의 핵심 파일입니다:

{
  "name": "my-portfolio",
  "version": "1.0.0",
  "scripts": {
    "dev": "vite",
    "build": "vite build"
  },
  "dependencies": {
    "gsap": "^3.12.5"
  },
  "devDependencies": {
    "vite": "^5.0.0"
  }
}
  • scripts — npm run dev 같은 명령어의 실제 내용
  • dependencies — 배포 환경에도 필요한 패키지
  • devDependencies — 개발할 때만 필요한 패키지

데모에서 확인하기

데모에서 package.json 필드를 클릭하면 각 항목의 역할을 한국어로 설명합니다.