분명 어제 되던 코드가 오늘 안 돼요 — 의존성/패키지가 뭔가요?

AI가 만들어준 프로젝트를 다른 컴퓨터에서 열었더니 새빨간 에러가 잔뜩 뜬 적 있으신가요. 코드는 손댄 적도 없는데 말이죠. 이럴 때 원인이 되는 게 "의존성(dependency)" 또는 "패키지(package)"입니다.

한 줄 정의

패키지는 내가 처음부터 만들지 않고 가져다 쓰는 남의 코드 뭉치이고, 의존성은 "내 프로젝트가 어떤 패키지들을 어떤 버전으로 필요로 하는지" 적어놓은 목록입니다.

왜 필요한가

버튼 디자인, 날짜 계산, 결제 연동 같은 기능을 매번 처음부터 짤 필요 없이 이미 만들어진 패키지를 가져다 쓰기 위해서입니다. 다만 이 패키지들은 내 프로젝트 폴더 안에 실제로 "설치"되어 있어야 작동하는데, 이 설치 파일들은 보통 용량이 커서 프로젝트를 옮기거나 공유할 때 같이 안 따라옵니다.

실전에서 이렇게

바이브코딩 중 새 컴퓨터나 새 코드 저장소에서 프로젝트를 받아왔는데 "모듈을 찾을 수 없습니다" 같은 에러가 뜬다면, 의존성이 설치가 안 된 상태인 겁니다. AI에게 "의존성 설치부터 해줘"라고 하면 목록에 적힌 패키지들을 전부 내려받아 채워 넣어줍니다.

비유

의존성 목록은 조립 가구의 부품 명세서 같은 겁니다. 명세서(목록)만 있다고 가구가 완성되진 않고, 명세서를 보고 실제 부품(패키지)을 상자에서 꺼내 끼워야 완성됩니다. 명세서만 들고 새집으로 이사가면, 부품은 다시 꺼내서 끼워 넣어야 하는 것과 같습니다.