IT Developer/Node.js

Node.js 기초 <5. npm과 패키지 관리: 의존성 관리 및 버전 관리>

TEMA_ 2025. 3. 7. 16:11
반응형

노드 Node.js

5. npm과 패키지 관리: 의존성 관리 및 버전 관리

 

안녕하세요! 태마입니다.

Node.js 기초 강좌입니다.

 

강좌의 경우 

1. 주제 간단 정리

2. 상세 주제 정리

으로 이루어져 있습니다.

 

노드 Node.js

포스팅 시작하겠습니다 :)

 


 

1. 주제 간단 정리

 

1. npm이란?

npm(Node Package Manager)은 Node.js에서 패키지를 설치하고 관리하는 도구입니다.
Node.js를 설치하면 npm도 자동으로 함께 설치됩니다.

📌 npm을 사용하면?
✔ 오픈소스 라이브러리를 손쉽게 설치하고 활용 가능
✔ 프로젝트의 의존성을 효율적으로 관리 가능
✔ 패키지 버전을 체계적으로 관리 가능


 

2. npm 기본 명령어

npm의 주요 명령어

명령어설명

npm init 프로젝트 초기화 및 package.json 생성
npm install <패키지명> 패키지 설치 (dependencies 추가됨)
npm uninstall <패키지명> 패키지 삭제
npm list 설치된 패키지 목록 확인
npm update <패키지명> 패키지 최신 버전으로 업데이트
npm outdated 업데이트 가능한 패키지 확인

📌 npm을 사용하면 다양한 패키지를 쉽게 관리할 수 있음!

✅ 여기까지 npm의 기본 개념과 주요 명령어를 배웠습니다!
👉 "그렇다면, npm의 패키지 관리와 버전 관리는 어떻게 이루어질까?"
2부에서 npm의 의존성 관리와 버전 제어 방법을 배워봅시다!

반응형

 

2. 상세 주제 정리

 

1. package.json – 프로젝트 환경 설정 파일

package.json은 npm 프로젝트의 필수 설정 파일로,
프로젝트의 패키지와 설정 정보를 관리합니다.

package.json 생성 방법

npm init -y   # 기본 설정으로 package.json 생성

package.json 예제

{
  "name": "my-node-app",
  "version": "1.0.0",
  "dependencies": {
    "express": "^4.18.2"
  }
}

📌 설치된 패키지는 dependencies에 자동으로 추가됨!


 

2. npm 의존성 관리 – dependencies vs devDependencies

npm의 의존성 종류

구분설명예제

dependencies 실행 시 필요한 패키지 express, axios
devDependencies 개발 환경에서만 필요한 패키지 nodemon, jest

개발용 패키지 설치 (devDependencies 추가)

npm install nodemon --save-dev

📌 개발 환경에서만 필요한 패키지는 --save-dev 옵션을 추가하여 설치!

프로덕션 환경에서 패키지 설치

npm install --production

📌 --production 옵션을 사용하면 개발용 패키지는 제외하고 설치됨!


 

3. npm 버전 관리 – Semver(시맨틱 버저닝) 이해하기

npm 패키지는 버전을 체계적으로 관리하기 위해 **시맨틱 버저닝(Semver)**을 사용합니다.

시맨틱 버저닝 형식

주버전.부버전.수정버전 (예: 1.2.3)

기호설명

1.0.0 최초 릴리즈
1.1.0 기능 추가 (하위 호환 유지)
2.0.0 기존 기능 변경 (하위 호환 X)

npm 버전 업데이트 명령어

npm update <패키지명>   # 최신 버전으로 업데이트
npm outdated            # 업데이트 가능한 패키지 확인

📌 npm update를 사용하면 패키지를 최신 버전으로 유지할 수 있음!


 

4. 글로벌 패키지 vs 로컬 패키지

1) 로컬 패키지 (프로젝트별로 설치)

npm install express   # 프로젝트 내부에 설치

📌 로컬 패키지는 프로젝트의 node_modules 폴더에 저장됨

2) 글로벌 패키지 (시스템 전역에서 사용)

npm install -g nodemon   # 시스템 전체에서 사용 가능

📌 글로벌 패키지는 모든 프로젝트에서 사용할 수 있음

3) 글로벌 패키지 목록 확인

npm list -g --depth=0

📌 설치된 글로벌 패키지를 확인할 수 있음!


 

5. npx 활용 – 설치 없이 패키지 실행

npx(Node Package eXecute)란?
npx는 패키지를 설치하지 않고 실행할 수 있는 도구입니다.

npx cowsay "Hello, Node.js!"

📌 npx 덕분에 일회성 패키지를 설치하지 않고 실행할 수 있음!


✅ 여기까지 npm과 패키지 관리 방법을 배웠습니다!
👉 "그렇다면, Node.js에서 웹 서버를 어떻게 구축할까?"
다음 회차에서 Express.js를 활용한 웹 서버 구축을 배워봅시다!

반응형