개발 언어/Node

npm이란 무엇인가요? 초보자를 위한 필수 npm 튜토리얼

주호파파 2025. 5. 7. 09:12
728x90
반응형

1. npm이란 무엇인가요?

npm(Node Package Manager) 은 JavaScript와 Node.js를 위한 패키지 관리 도구로, 코드 모듈("패키지"라고 함)을 설치, 관리, 공유하는 데 사용됩니다.

  • npm 주요 기능 :
    • 📦 종속성 (React, Vue, Lodash 및 기타 타사 라이브러리 등)을 설치하고 관리합니다 .
    • 🔄버전 제어 (종속성의 버전 범위 지정)
    • 🚀 스크립트 실행 (예 npm start: , npm test)
    • 🌍 자신의 패키지를 게시하세요 (npm 공식 저장소에 코드 공유)
  • npm과 Node.js의 관계 :
    • npm은 Node.js의 기본 패키지 관리자이며 Node.js를 설치하면 자동으로 설치됩니다.
    • 버전은 node -v및 를 사용하여 확인할 수 있습니다 .npm -v

npm 소개

 

2. npm의 기본 사용법

(1) 프로젝트 초기화(package.json 생성)

package.json이는 프로젝트의 구성 파일로, 프로젝트 정보, 종속성, 스크립트를 기록합니다.

npm init    # 대화형으로 package.json 생성하기
npm init -y # 빠른 생성(기본값 사용)
 

실행 후, 다음 package.json과 비슷한 내용의 파일이 생성됩니다.

{
  "name": "my-project",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC"
}
 

(2) 종속 패키지 설치

npm은 로컬 종속성 (현재 프로젝트에서만 사용 가능)이나 글로벌 종속성 (모든 프로젝트에서 사용 가능) 을 설치할 수 있습니다 .

 

npm install <package> 종속성 설치(기본적으로 로컬) npm install lodash
npm install -g <package> 글로벌 설치 npm install -g nodemon
npm install --save-dev <package> 개발 종속성(ESLint, Webpack 등) 설치 npm install --save-dev eslint
npm install package.json모든 종속성을 설치 npm install

 

예: React

npm install react react-dom
 

설치 후 종속성은 또는 package.json에 기록됩니다 .

 

(3) 종속성 제거

npm uninstall <package> # 로컬 종속성 제거
npm uninstall -g <package> # 전역 종속성 제거
npm uninstall --save-dev <package> # 개발 종속성 제거
 

예: lodash

npm uninstall lodash

(4) 스크립트 실행(npm 스크립트)

package.json이 scripts필드에서는 개발 서버 시작, 테스트 실행 등의 바로가기 명령을 정의할 수 있습니다.

 :

{
  "scripts": {
    "start": "node index.js",
    "dev": "vite",
    "build": "vite build",
    "test": "jest"
  }
}

스크립트를 실행합니다:

npm run dev # 개발 스크립트 실행
npm run build # 빌드 스크립트 실행
npm start # 시작 실행 (실행 생략)
npm test # 테스트 실행(실행 생략)

3. 일반적인 npm 명령어에 대한 빠른 참조 표

 

npm init 프로젝트 초기화
npm install 모든 종속성을 설치
npm install <package> 지정된 패키지를 설치
npm uninstall <package> 패키지 제거
npm update 모든 종속성 업데이트
npm outdated 오래된 종속성 확인
npm list 설치된 종속성 보기
npm run <script> 사용자 정의 스크립트 실행
npm publish 자신의 패키지 게시
npm login npm 계정에 로그인
npm cache clean 캐시 지우기

4. 일반적인 문제 및 최적화 팁

(1) npm 설치가 느린가요? 이 방법을 시도해보세요

  • 미러 소스 전환 (예: Taobao 소스):
  • **사용 --prefer-offline**​ (캐싱을 선호):
  • ** pnpm또는 yarn**​ (더 빠른 대안):

(2) **node_modules**너무 큰가요?

  • npm prune사용하지 않는 종속성을 제거하려면 다음을 사용하세요.
  • 디스크 사용량을 줄이려면 pnpm사용 하세요 yarn

(3) npm을 업데이트하는 방법은 무엇입니까?

npm install -g npm@latest

5. 결론

  • npm은 JavaScript 종속성을 관리하는 Node.js용 패키지 관리자입니다 .
  • 핵심 운영 : npm init, npm install, npm run.
  • 최적화 팁 : 이미지 소스를 변경하고, 캐시를 사용하고, pnpm/를 시도해 보세요 yarn.

🚀이제 npm으로 새로운 프로젝트를 만들어보세요!

mkdir my-app && cd my-app
npm init -y
npm install express

 

728x90
반응형