📘 Node.js 실무 백엔드 개발

 

📖 2장. 개발 환경 구축과 첫 서버 실행


2.1 개발 환경의 중요성

백엔드 개발은 실행 환경에 크게 의존한다.
따라서 안정적이고 일관된 개발 환경을 구축하는 것은 프로젝트의 품질과 직결된다.

개발 환경은 다음 요소로 구성된다:

  • 런타임(Runtime)
  • 패키지 관리자
  • 프로젝트 구조
  • 실행 도구

2.2 Node.js 설치 및 확인

Node.js는 공식 웹사이트에서 설치할 수 있으며, 설치 후 정상 동작 여부를 확인해야 한다.

버전 확인

node -v
npm -v

정상적으로 설치되었다면 버전 정보가 출력된다.


2.3 프로젝트 초기화

Node.js 프로젝트는 npm을 통해 초기화된다.

mkdir server
cd server
npm init -y

이 과정에서 package.json 파일이 생성된다.


2.4 package.json의 역할

package.json은 프로젝트의 설정과 의존성을 관리하는 핵심 파일이다.

주요 항목:

  • name: 프로젝트 이름
  • version: 버전
  • scripts: 실행 명령어
  • dependencies: 설치된 라이브러리 목록

2.5 기본 서버 실행

Node.js는 기본적으로 HTTP 서버를 직접 생성할 수 있다.

const http = require('http');

const server = http.createServer((req, res) => {
  res.end('Hello World');
});

server.listen(3000, () => {
  console.log('Server running on port 3000');
});

2.6 서버 실행 방법

node app.js

브라우저에서 http://localhost:3000 접속 시 결과를 확인할 수 있다.


2.7 프레임워크 도입의 필요성

기본 HTTP 모듈만으로도 서버를 만들 수 있지만, 다음과 같은 한계가 있다:

  • 라우팅 관리 어려움
  • 코드 가독성 저하
  • 확장성 부족

이를 해결하기 위해 프레임워크를 사용한다.


2.8 Express.js 설치

Express는 Node.js에서 가장 널리 사용되는 웹 프레임워크이다.

npm install express

2.9 Express 서버 생성

const express = require('express');
const app = express();

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

app.listen(3000, () => {
  console.log('Server started');
});

2.10 미들웨어 개념

Express의 핵심은 미들웨어(Middleware)이다.

미들웨어는 요청과 응답 사이에서 동작하는 함수이다.

요청 → 미들웨어 → 라우터 → 응답

예시:

app.use(express.json());

2.11 개발 편의 도구

개발 생산성을 높이기 위해 다음 도구를 사용한다:

  • nodemon: 코드 변경 시 자동 재시작
npm install -D nodemon

2.12 실행 스크립트 설정

package.json에 실행 명령어를 추가한다:

"scripts": {
  "start": "node app.js",
  "dev": "nodemon app.js"
}

2.13 정리

이 장에서는 개발 환경을 구축하고, Node.js와 Express를 사용해 첫 서버를 실행하였다.

핵심 내용:

  • Node.js 프로젝트 초기화
  • Express 서버 생성
  • 미들웨어 개념 이해

다음 장에서는 라우팅과 API 설계를 통해 실제 서버 구조를 구성한다.

+ Recent posts