node.js + express 초기 세팅 방법

이도형·2024년 8월 15일

web

Web 기본개념📶

목록 보기

5/10

백엔드로 Node.js와 Express가 자주 쓰이곤 합니다.
하지만, 해당 환경을 사용하기 위해서 초기 세팅이 필요합니다.
초기 세팅 방법에 대해 알아보겠습니다.

1. Node.js 설치

우선 Node.js를 사용해주기 위해 설치를 해줘야합니다.

https://nodejs.org/en

이 때, LTS (Long Term Support)가 장기 지원되므로, 더욱 안정적입니다.

2. Node, npm 버전 확인

Node.js가 제대로 설치되었는지 Terminal을 통해 확인합니다.

$ node -v

이 후 npm 역시 제대로 설치되었는지 Terminal을 통해 확인합니다.

$ npm -v

3. package.json 정의

이 후 새로운 프로젝트 폴더를 생성하고
해당 폴더에 package.json 파일을 생성하려면 아래의 내용을 Terminal에 입력해야합니다.

$ npm init

또는

$ npm init -y

이 때 -y는 붙이면,

{
  "name": "폴더 이름",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "description": ""
}

기본 세팅이 된 상태로 package.json이 생성되지만,
이를 하나하나 입력하고 싶다면 npm init만 입력하면 됩니다.

4. express 설치

Express를 설치하려면 npm을 통해 설치해야합니다.

$ npm i express // 기본적으로 설치
$ npm i express --save // 설치하면서 명시적으로 dependencies에 추가
$ npm i express --save-dev // package.json의 devDependencies에 추가 (프로덕션 환경에서는 설치⨉)
$ npm i express --no-save // 설치하지만 package.json에 영향⨉

이 때 프로젝트 폴더에 node_modules 폴더가 생성되고,
package.json에 명령어에 따라 영향을 줍니다.

(4.5. nodemon 설치)

nodemon : Node.js에서 소스 코드의 변경을 자동으로 감지하여 서버를 재시작해주는 모듈

아래 명령어를 통해 설치합니다

$ npm i nodemon

5. js 파일 생성

js파일을 생성하여 작동이 되는지 확인합니다.

// app.js
const express = require("express");
const app = express();

app.get("/", (req, res) => {
  res.send("Hello World!");
});

app.listen(3306, () => console.log("PORT START 3306"));

이 후 아래 명령어를 Terminal에 입력하고, 작동을 하는지 확인합니다.

$ node app // node 사용
$ nodemon app // nodemon 사용 (app.js를 바꾸면 즉시 적용)

Terminal 확인

localhost 확인

(5.5. 실행 명령어 생성)

실행 명령어를 통해 명령어를 더욱 단순화 시킬 수 있습니다.
이는 package.json파일의 scripts:를 수정하여 바꿀 수 있습니다.

// package.json
"scripts": {
    "start": "node app"
  },

예를 들어 이와 같이 바꿨다면
npm start 명령어를 입력해도 같은 동작을 합니다.

추가로

이 후 Git에 올릴 때는 .gitignore를 통해 node_modules와 package-lock.json 파일은 제외하고 push하는 것이 선호됩니다.

또한 CORS, dotenv, morgan 등의 모듈은 자주 사용되므로 설치하고 활용하는 것이 권장됩니다.

마치며

Node를 공부한 개발자로서 기존에 세팅된 상황에는 익숙했지만, 처음부터 Node를 세팅하는데에 머뭇거린 경우도 많았습니다.
하지만, 개발자의 기본인 환경 세팅을 해당 글을 통해 정리하면서 언제든 새로운 환경에서 Node와 Express 환경을 세팅할 수 있는 능력을 키웠습니다.