728x90

Node.js 개발 환경 구성 방법

Node.js는 JavaScript 런타임으로, 백엔드 서버 개발에 널리 사용됩니다. 이 글에서는 Node.js 개발 환경을 처음 구성하는 방법을 단계별로 정리합니다.

1단계: Node.js 설치

Node.js는 공식 웹사이트에서 설치할 수 있습니다.

어떤 버전을 설치할까?

LTS (Long Term Support): 안정적인 장기 지원 버전. 추천
Current: 최신 기능 포함, 실험적 프로젝트에 적합

설치 방법

Windows / macOS
- 위 링크에서 OS에 맞는 설치 프로그램 다운로드 및 실행
Ubuntu (리눅스)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs

2단계: 설치 확인

터미널 또는 명령 프롬프트에서 아래 명령어를 입력해 설치가 제대로 되었는지 확인합니다.

node -v   # Node.js 버전 확인
npm -v    # npm (패키지 관리자) 버전 확인

정상적으로 출력되면 설치가 완료된 것입니다.

3단계: 프로젝트 폴더 생성 및 이동

작업할 프로젝트 폴더를 생성하고 해당 디렉토리로 이동합니다.

mkdir my-node-app
cd my-node-app

4단계: package.json 초기화

Node.js 프로젝트는 package.json 파일로 의존성과 프로젝트 설정을 관리합니다.

자동 생성 명령어

npm init -y

-y 플래그를 사용하면 기본값으로 자동 생성됩니다. 이후 필요시 내용을 수정할 수 있습니다.

5단계: 의존성 설치

필요한 라이브러리를 설치해 개발에 사용할 수 있습니다. 예를 들어 express라는 웹 프레임워크를 설치해 봅니다.

npm install express

설치된 모듈은 node_modules/ 폴더에 저장되며, package.json의 dependencies 항목에 자동으로 추가됩니다.

6단계: 실행 테스트

간단한 서버를 만들어 프로젝트 실행을 테스트해봅니다.

1. index.js 파일 생성

// index.js
const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.send('Hello, Node.js!');
});

app.listen(3000, () => {
  console.log('Server is running on http://localhost:3000');
});

2. 실행

node index.js

브라우저에서 http://localhost:3000 으로 접속했을 때 "Hello, Node.js!" 메시지가 보이면 개발 환경 구성이 완료된 것입니다.

마무리

이제 Node.js 개발 환경이 구축되었습니다. 이후에는 아래와 같은 방향으로 프로젝트를 발전시킬 수 있습니다.

TypeScript 도입
ESLint / Prettier 설정
dotenv 등 환경변수 관리
nodemon으로 자동 재시작

다음 글에서는 이 중 TypeScript 도입에 대해 알아보겠습니다.