依赖Dependency

你可能会说

刚下载好的项目一运行就报找不到模块，是代码坏了吗？

项目声明会使用的外部代码包，通常由包管理器按清单安装克隆项目后，package.json 记录项目声明的依赖，锁文件记录解析出的具体版本；包管理器据此准备本地安装目录。源码仓库通常不提交 node_modules。遇到 Cannot find module 可以先看依赖是否安装，再按项目提示启动并核对实际报错。

先知道

npm

也常被叫作依赖包Dependency

从克隆到启动：依赖在哪一步进入项目

my-first-page/还没有 node_modules

package.json记录需要哪些依赖

src/

node_modules/不存在

Terminal

$ npm start
Error: Cannot find module 'react'
依赖还没安装

清单在，依赖本体不在：先安装再启动

模块找不到时先分清：没装依赖、版本不匹配、还是代码引用写错——三步的报错信息各不相同。

依赖为什么需要单独安装

项目只存清单，不存依赖本身：仓库里通常只有一份记录文件，写着项目需要哪些包和版本；依赖本体按需下载，不进版本库。

安装准备本机的依赖目录：包管理器读取清单和锁文件，下载或复用所需包并准备本地安装目录；新克隆项目或依赖变化后，通常要按项目说明重新安装。

报错对应不同原因：Cannot find module 先怀疑没装依赖；装过仍报错，再看版本是否匹配、是不是代码引用路径写错。

你可以这样告诉 AI Agent

刚克隆的项目运行时报 Cannot find module。请先运行安装依赖的命令，确认依赖清单里的包都装好，再重新启动。如果安装失败，说明是哪个包装不上、为什么，不要改业务代码绕过。

接下来学什么

1npm→2语义化版本Semantic Versioning→

新克隆的项目运行 npm start 时报 Cannot find module 'react'。下一步怎么做？

A. 让 AI 把 import react 的代码删掉重写B. 重新安装 Node.js，因为模块找不到是环境问题C. 先运行 npm install 安装依赖，再重新启动项目