Module not found

一句话：项目找不到某个模块，常见原因是依赖没安装、包名写错、路径错误或构建配置没有识别。

它是什么

Module not found 是前端、Node.js和Python项目里常见的找不到模块错误。它表示程序引用了某个包或文件，但运行环境无法在当前路径、依赖目录或配置路径中找到它。

适合干什么

• 前端项目启动失败
• Node.js项目依赖缺失
• Python import报错
• 复制别人代码后跑不起来

不适合干什么

• 模块找到了但内部运行崩溃
• 网络安装依赖失败
• 运行时权限或数据库连接错误

普通人怎么用

• 看报错里缺的是包还是文件
• 如果是包，检查package.json或requirements.txt
• 执行安装依赖命令
• 如果是文件，检查路径和大小写
• 重启开发服务器

进阶用户怎么用

• 检查别名配置如tsconfig paths或webpack alias
• 确认当前工作目录正确
• 清理node_modules和锁文件后谨慎重装
• 区分默认导入和命名导入问题

常见误区

• 不看报错里到底缺哪个模块
• Windows不区分大小写导致上线后Linux报错
• 在错误目录执行安装命令
• 把路径问题误判为依赖问题

和相似工具的区别

• Module not found vs Cannot find module：两者都表示找不到模块，具体措辞会随语言、打包器和运行环境不同。
• 包缺失 vs 文件路径错误：包缺失通常需要安装依赖，文件路径错误通常需要修改import路径或文件名大小写。

入门步骤

• 定位报错缺失名称
• 判断是第三方包还是本地文件
• 安装依赖或修正路径
• 检查大小写
• 重新启动项目

推荐工具（第三方）

ChatGPT、Cursor、VS Code、npm、pnpm、pip