Choorai

패키지/의존성 기초

프로젝트가 외부 라이브러리를 어떻게 설치하고, 버전을 어떻게 고정하는지 실전 기준으로 정리합니다.

핵심 용어

  • Dependency: 실행에 필요한 패키지
  • devDependency: 개발/빌드에만 필요한 패키지
  • Lockfile: 설치 버전을 고정하는 파일
  • SemVer: 메이저/마이너/패치 버전 체계

Node 생태계 기본 흐름

터미널
# 의존성 설치
npm install

# 런타임 의존성 추가
npm install axios

# 개발 의존성 추가
npm install -D vitest

# 락파일 기준 재설치
npm ci

Python 생태계 기본 흐름

터미널
# 가상환경 생성/활성화
python -m venv .venv
source .venv/bin/activate

# 패키지 설치
pip install fastapi uvicorn

# 버전 고정 파일 생성
pip freeze > requirements.txt

60분 챌린지 연결 지점

초심자 실수 TOP 3

  • node_modules를 Git에 커밋
  • 락파일 없이 설치해 팀원마다 버전이 달라짐
  • 전역 설치와 프로젝트 설치를 혼동

검증 체크리스트

  • package-lock.json 또는 requirements.txt 커밋 여부 확인
  • CI에서는 npm ci 같은 재현 가능한 설치 방식 사용
  • 버전 충돌 발생 시 캐시 삭제 후 재설치

마지막 업데이트: 2026년 2월 22일 · 버전: v0.0.1

피드백 보내기

입력한 내용으로 새 이슈 페이지를 엽니다.

GitHub 이슈로 보내기