패키지 설치하기
다른 사람의 코드를 본인 프로젝트에 추가하기
⏱ 예상 ~9분
01 · 읽기
이제 첫 번째 npm 패키지를 설치할 거예요: Express. Express 는 JavaScript 에서 가장 인기 있는 web 서버 프레임워크예요. 주당 3000 만 명이 넘는 엔지니어가 다운로드해요.
npm install 을 실행하면 세 가지가 일어나요:
1. npm 이 registry 에서 패키지를 다운로드 2. 코드를 node_modules 폴더에 저장 3. 패키지 이름을 본인 package.json 의 dependencies 아래에 기록
계속 진행하기 전에 아직 my-server 폴더 안에 있는지 확인해요.
02 · 실기 실습
Express 를 설치해요. 이건 Express 와 그게 의존하는 모든 패키지를 본인 프로젝트에 다운로드해요. 터미널에서 아래 명령어를 실행하고, 완료될 때까지 기다린 다음, 'I did it' 을 눌러서 계속해요.
npm install express
03 · 실기 실습
이제 package.json 을 다시 봐요. 새로운 dependencies 블록에 Express 가 나열된 게 보일 거예요.
cat package.json
04 · 퀴즈
본인 프로젝트의 의존성을 추적해서 다른 사람도 설치할 수 있게 해주는 파일은?
- package.json
- node_modules/index.js
- dependencies.txt
- .npmrc
05 · 실기 실습
node_modules 안을 슬쩍 봐요. npm 이 다운로드한 모든 패키지를 저장하는 폴더예요. Express 는 동작하려면 다른 패키지가 많이 필요해서, 'express' 뿐만 아니라 더 많은 게 보일 거예요.
ls node_modules | head -20
06 · 빈칸 채우기
Express 를 설치하려면, npm _____ express 를 쳐요.
07 · 읽기
폴더가 정말 많아요! Express 는 다른 패키지에 의존하고, 그 패키지들은 또 다른 패키지에 의존해요. 이걸 의존성 트리 (dependency tree) 라고 해요.
중요한 것: node_modules 는 절대 git 에 commit 하지 마세요. 수천 개의 파일과 수백 MB 가 될 수 있어요. 본인의 package.json 이 뭐가 필요한지 기록하고, 본인 프로젝트를 clone 하는 누구든 npm install 을 실행해서 다시 다운로드할 수 있어요.
그게 package.json 이 그렇게 중요한 이유예요. 그건 레시피예요. node_modules 는 재료고요.
💡 상상해 봐요package.json 은 쇼핑 리스트예요. node_modules 는 실제 식료품이에요. 본인은 리스트를 공유하지, 트럭 한 대 분량의 음식을 공유하지 않아요.
핵심 정리
- npm install 은 패키지를 node_modules/ 에 다운로드해요
- package.json 은 본인 프로젝트가 어떤 패키지에 의존하는지 기록해요
- node_modules 는 git 에 절대 commit 하지 마세요. 너무 커요
- 누구든 npm install 로 node_modules 를 다시 만들 수 있어요
08 · 퀴즈
동료가 본인의 GitHub 프로젝트를 clone 했는데, node_modules 폴더가 없어요. 모든 의존성을 받으려면 뭘 실행해야 하나요?
- npmjs.com 에서 각 패키지를 수동으로 다운로드해야 해요
- npm install — package.json 을 읽어서 모든 걸 다운로드해요
- node install — Node.js 가 의존성 관리를 처리해요
- 불가능해요. 원본 node_modules 없이는 프로젝트가 안 돌아가요
⚠ 전체 인터랙티브 경험에는 JavaScript가 필요해요. JavaScript를 켜고 새로 고침해 주세요.
※ 이 사이트는 독립 운영되는 교육 프로젝트로, Anthropic의 공식 제품이 아니에요. Claude™ 는 Anthropic, PBC 의 상표예요.