📚 Reference

📜 Chapter

npm

yarn

pnpm

유령 의존성 (Phantom Dependencies)

• 유령 의존성
• Phantom Dependencies
• package.json 파일에 직접 명시되지 않은 패키지가 코드에서 사용될 때 발생하는 문제이다.
• 기존 npm이나 Yarn Classic과 같은 패키지 관리자는 node_modules 디렉토리를 플랫하게(flat) 구성하는 경향이 있었다.
• 이는 패키지 트리의 깊이를 줄여 파일 경로 문제를 해결하고 설치 속도를 개선하려는 목적이 있었다.

예시

• 프로젝트 A가 패키지 foo에 의존하고, foo는 다시 패키지 bar에 의존한다고 가정해 보자.
• 프로젝트 A -> foo -> bar
• 기존 패키지 관리자의 플랫한 node_modules 구조에서는 node_modules 최상위에 foo와 bar가 모두 설치될 수 있다.

your-project/
└── node_modules/
    ├── foo/ (프로젝트 A의 직접 의존성)
    └── bar/ (foo의 의존성이지만 최상위에 설치됨)

• 이런 경우, your-project 코드에서 bar를 직접 require('bar') 또는 import 'bar' 해서 사용할 수 있게 된다.
• 하지만 bar는 package.json에 명시된 직접적인 의존성이 아니다. 즉, "유령처럼 존재하지만 실제로는 정의되지 않은" 의존성인 셈이다.