패키지 매니저 (npm)

🤔 혹시 이런 경험 있나요?

AI가 만들어준 프로젝트를 열었는데, 첫 번째로 하라는 말이 항상 같습니다.

“

"터미널에서 npm install을 실행하세요."

시키는 대로 하면 뭔가 잔뜩 설치되고, node_modules라는 엄청나게 큰 폴더가 생깁니다. 도대체 뭘 설치한 건지, 왜 이렇게 많은 건지, 이 폴더를 지워도 되는 건지 궁금한 적 없나요?

🔑 패키지 매니저, 한마디로 뭘까요?

패키지 매니저(npm)는 다른 개발자가 만든 코드를 내 프로젝트에 쉽게 가져다 쓸 수 있게 해주는 도구입니다.

npm은 Node Package Manager의 약자로, JavaScript/Node.js 생태계에서 가장 많이 사용되는 패키지 매니저입니다. 패키지(Package)란 누군가가 특정 기능을 미리 만들어놓은 코드 묶음을 말합니다.

🧱 레고 블록과 같습니다

집을 짓는다고 생각해보세요.

• 모든 걸 직접 만들기: 벽돌을 직접 굽고, 시멘트를 직접 만들고, 창문 유리를 직접 자르기
• 기성품 활용하기: 건축 자재점에서 벽돌, 시멘트, 창문을 사 와서 조립하기

프로그래밍도 마찬가지입니다. 로그인 기능, 날짜 계산, 이미지 최적화 같은 기능을 처음부터 만들 필요 없이, 이미 잘 만들어진 패키지를 가져다 쓰면 됩니다.

npm은 이 건축 자재점 역할을 합니다. 전 세계 개발자가 만든 200만 개 이상의 패키지가 등록되어 있고, 명령어 한 줄로 설치할 수 있습니다.

📦 핵심 파일과 폴더 이해하기

1. package.json - 재료 목록표

프로젝트에 필요한 패키지 목록이 적혀있는 파일입니다.

• dependencies: 프로젝트 실행에 필요한 패키지 (재료)
• devDependencies: 개발할 때만 필요한 패키지 (공구)

2. node_modules - 실제 재료 보관 창고

npm install을 실행하면 생기는 폴더입니다. package.json에 적힌 패키지들이 여기에 설치됩니다.

• 용량이 매우 큽니다 (수백 MB인 경우도 있습니다)
• GitHub에 올리면 안 됩니다 (.gitignore에 포함되어 있어야 합니다)
• 삭제해도 npm install 하면 다시 생깁니다

3. package-lock.json - 정확한 버전 기록표

설치된 패키지의 정확한 버전을 기록하는 파일입니다. 다른 컴퓨터에서도 동일한 버전의 패키지가 설치되도록 보장합니다.

• 삭제하지 마세요.
• GitHub에 함께 올려야 합니다.

🛠️ 바이브코딩에서 자주 쓰는 npm 명령어

“

팁: AI가 "이 패키지를 설치하세요"라고 하면, npm install 패키지이름을 터미널에 입력하면 됩니다.

⚡ npm vs yarn vs pnpm

패키지 매니저는 npm 말고도 여러 가지가 있습니다.

기능은 거의 같습니다. AI가 yarn add라고 하면 yarn을, pnpm add라고 하면 pnpm을 쓰면 됩니다. 프로젝트에서 사용하는 것 하나를 골라 일관되게 사용하는 것이 중요합니다.

⚠️ 바이브코딩할 때 주의할 점

1. "npm install 안 돼요" 대처법

• Node.js가 설치되어 있는지 확인하세요. (node --version으로 확인)
• 올바른 폴더에서 실행하고 있는지 확인하세요. (package.json이 있는 폴더)

2. node_modules를 GitHub에 올리지 마세요

• .gitignore에 node_modules가 포함되어 있는지 확인하세요.
• 다른 사람은 npm install로 직접 설치하면 됩니다.

3. 패키지 버전 충돌에 주의하세요

• AI가 최신 패키지를 설치하라고 했는데 에러가 난다면, 다른 패키지와 버전이 맞지 않는 경우가 많습니다.
• 에러 메시지를 AI에게 보여주면 호환되는 버전을 알려줄 것입니다.

📋 30초 요약

1. npm은 다른 사람이 만든 코드(패키지)를 내 프로젝트에 가져다 쓸 수 있게 해주는 도구입니다. 건축 자재점에서 재료를 사 오듯, npm install 패키지이름으로 원하는 기능을 추가할 수 있습니다.

2. package.json은 재료 목록, node_modules는 재료 창고입니다. node_modules는 삭제해도 npm install로 복구됩니다. GitHub에는 package.json만 올리고, node_modules는 올리지 않습니다.

3. AI가 가장 먼저 npm install을 시키는 이유는 프로젝트에 필요한 모든 패키지를 설치하기 위해서입니다. 이게 안 되면 프로젝트가 실행되지 않으므로, Node.js 설치 여부와 현재 폴더 위치를 확인하세요.