“幽灵依赖”是指项目中实际使用但未在 package.json 中显式声明的依赖项。排查幽灵依赖可以帮助避免潜在的版本冲突和运行时错误。以下是排查幽灵依赖的几种常见方法：

1. 使用 npm ls 或 yarn list 命令

   • 运行 npm ls 或 yarn list 可以查看项目中安装的所有依赖及其依赖树。通过检查输出，可以找到未在 package.json 中声明的依赖。
   • 例如，运行 npm ls --depth=0 可以查看直接依赖，而 npm ls --depth=1 可以查看直接依赖及其一级子依赖。

2. 使用 depcheck 工具

   • depcheck 是一个专门用于检测未使用依赖和幽灵依赖的工具。安装并运行它：

     npm install -g depcheck
     depcheck
     

   • 它会列出项目中未在 package.json 中声明但被使用的依赖。

3. 检查 node_modules 目录
   手动检查 node_modules 目录，查看是否有未在 package.json 中声明的包。虽然这种方法比较繁琐，但对于小型项目可能有效。

4. 使用 npm prune 或 yarn autoclean
   运行 npm prune 或 yarn autoclean 可以移除未在 package.json 中声明的依赖。这可以帮助清理项目中的幽灵依赖，但需谨慎使用，以免误删必要的依赖。

5. 检查构建工具配置
   某些构建工具（如 Webpack、Vite）可能会自动引入依赖。检查构建工具的配置文件，确保没有隐式引入的依赖。

6. 使用 package-lock.json 或 yarn.lock
   检查 package-lock.json 或 yarn.lock 文件，查看是否有未在 package.json 中声明的依赖。这些文件记录了所有安装的依赖及其版本。

7. 代码审查
   通过代码审查，检查是否有直接引用未在 package.json 中声明的模块。例如，检查 import 或 require 语句。

总结
排查幽灵依赖需要结合工具和手动检查。推荐使用 depcheck 工具进行自动化检测，并结合 npm ls 或 yarn list 进行验证。定期清理和审查依赖，可以避免项目中出现不必要的依赖冲突。