Node.js 설치 및 설정 방법

1. Node.js 버전 선택

Node.js는 공식 사이트에서 두 가지 버전을 제공합니다.

• LTS (Long Term Support): 안정성이 검증된 장기 지원 버전으로 프로덕션 환경에 권장
• Current: 최신 기능이 포함된 버전으로 새로운 기능을 테스트할 때 사용

일반적인 개발 및 운영 환경에서는 LTS 버전을 사용하는 것이 권장됩니다. 2024년 기준 LTS 버전은 20.x 시리즈입니다.

2. 운영체제별 설치 방법

2.1 Windows

Node.js 공식 사이트(https://nodejs.org)에서 Windows Installer(.msi)를 다운로드하여 설치합니다.

# 설치 후 버전 확인
node -v
npm -v

설치 시 "Add to PATH" 옵션이 기본으로 선택되어 있어 별도의 환경 변수 설정이 필요 없습니다.

2.2 macOS

Homebrew를 사용한 설치가 가장 편리합니다.

# Homebrew로 설치
brew install node

# 버전 확인
node -v
npm -v

또는 공식 사이트에서 macOS Installer(.pkg)를 다운로드하여 설치할 수 있습니다.

2.3 Linux (Ubuntu/Debian)

NodeSource 저장소를 추가하여 최신 버전을 설치합니다.

# NodeSource 저장소 추가 (Node.js 20.x)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

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

# 버전 확인
node -v
npm -v

3. NVM을 이용한 버전 관리

여러 프로젝트에서 서로 다른 Node.js 버전을 사용해야 할 때 NVM(Node Version Manager)이 유용합니다.

3.1 NVM 설치

# NVM 설치 (macOS/Linux)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 터미널 재시작 후 확인
nvm --version

3.2 NVM 사용법

# 설치 가능한 버전 목록 확인
nvm ls-remote

# 특정 버전 설치
nvm install 20.10.0

# LTS 버전 설치
nvm install --lts

# 설치된 버전 목록 확인
nvm ls

# 사용할 버전 선택
nvm use 20.10.0

# 기본 버전 설정
nvm alias default 20.10.0

반응형

4. 프로젝트 초기 설정

4.1 package.json 생성

# 프로젝트 폴더 생성 및 이동
mkdir my-project
cd my-project

# package.json 생성 (대화형)
npm init

# package.json 생성 (기본값으로 빠르게)
npm init -y

4.2 package.json 구조

{
  "name": "my-project",
  "version": "1.0.0",
  "description": "프로젝트 설명",
  "main": "index.js",
  "scripts": {
    "start": "node index.js",
    "dev": "node --watch index.js"
  },
  "keywords": [],
  "author": "",
  "license": "ISC"
}

4.3 패키지 설치

# 프로덕션 의존성 설치
npm install express

# 개발 의존성 설치
npm install --save-dev nodemon

# 전역 설치
npm install -g typescript

5. 개발 환경 설정

5.1 nodemon 설정

코드 변경 시 자동으로 서버를 재시작하는 nodemon을 설정합니다.

npm install --save-dev nodemon

package.json의 scripts에 추가:

{
  "scripts": {
    "dev": "nodemon index.js"
  }
}

5.2 환경 변수 설정

dotenv 패키지를 사용하여 환경 변수를 관리합니다.

npm install dotenv

// .env 파일
PORT=3000
DATABASE_URL=mongodb://localhost:27017/mydb

// index.js
require('dotenv').config();
console.log(process.env.PORT); // 3000

결론

Node.js 설치는 공식 사이트에서 LTS 버전을 다운로드하거나, NVM을 사용하여 여러 버전을 관리하는 방법이 있습니다. 프로젝트 시작 시 npm init으로 package.json을 생성하고, nodemon과 dotenv를 설정하면 효율적인 개발 환경을 구축할 수 있습니다.