依赖安装失败

一句话：运行 npm install、pip install、pnpm install 时失败，通常和网络、版本、权限、锁文件或依赖冲突有关。

它是什么

依赖安装失败是编程新手最常见的报错之一。依赖就是项目需要的第三方包，安装失败会导致项目无法启动。AI编程时，很多问题并不是代码错，而是依赖没装好。

适合干什么

• 运行开源项目时卡在安装步骤的人
• 看到 npm ERR、pip error、pnpm failed 不知道怎么办的人
• 使用Cursor、Codex、Claude Code修项目的人
• 需要把报错交给AI定位的人

不适合干什么

• 项目已经成功启动但功能逻辑错误的情况
• 服务器硬件或系统损坏导致的问题
• 没有完整报错信息的盲目排查

普通人怎么用

• 先确认自己在项目根目录
• 确认使用了项目要求的Node或Python版本
• 复制完整安装命令和完整报错
• 不要只看最后一行，要找第一个真正的error
• 把系统、版本、包管理器告诉AI

进阶用户怎么用

• 根据锁文件判断应该使用npm、pnpm、yarn还是pip
• 删除 node_modules 后重新安装，但先保留锁文件
• 检查网络代理、镜像源和权限问题
• 把错误分为版本不兼容、包不存在、编译失败、权限不足四类

常见误区

• 看到报错就反复执行同一条命令
• 随便删除锁文件导致依赖版本漂移
• 混用多个包管理器
• 只发截图给AI，截图里还缺少关键报错

和相似工具的区别

• 依赖安装失败 vs 项目启动失败：安装失败发生在下载和安装包阶段，启动失败发生在依赖装好之后运行项目阶段。
• 警告 vs 错误：warning通常不一定阻止安装，error才是优先排查对象。

入门步骤

• 复制完整报错
• 检查当前目录
• 检查Node或Python版本
• 确认包管理器
• 按错误类型逐步修复

推荐工具（第三方）

ChatGPT、Claude、Cursor、VS Code Terminal、npm、pip