前端报错汇总

按报错关键字速查 关键字 大概率原因 跳转 Failed to resolve import 路径 / 别名 / 大小写 02 §2.1 Cannot find module 没装 / TS path

8.1 'React' must be in scope when using JSX 原因:老规则,React 17+ 不再需要 import React。 修法:.eslintrc 关掉: 8.2

现象 原因 解决 改文件页面不刷新 WSL / Docker 文件系统 inotify 失效 server.watch.usePolling: true(性能差,本地原生不要开) 状态被重置 改了非组

6.1 error during build: Rollup failed to resolve import "xxx" 症状:dev 能跑、npm run build 报错。 原因:dev 下 V

5.1 Network Error / ERR_CONNECTION_REFUSED 原因:后端没起或端口不对。 定位: 本项目后端默认 9002,见 ../运行指南.md 前端代理目标也是 9002

4.1 Hooks can only be called inside the body of a function component 原因(三选一): 在条件 / 循环 / 嵌套函数里调用 Hoo

3.1 TS2307: Cannot find module '@/xxx' or its corresponding type declarations 原因:Vite 的 alias 配了,但 T

2.1 Failed to resolve import "xxx" from "src/yyy" 高频原因: 路径别名未配置或拼错:本项目 @ 指向 frontend/src,见 vite.conf

1.1 npm ERR! ERESOLVE unable to resolve dependency tree 现象:npm install 时报 peerDependency 冲突。 原因:reac

五步定位法 看报错来源 浏览器控制台 → 运行时(JS / 渲染 / 网络) Vite 终端 → 编译 / 依赖解析 / HMR TS 编译器(tsc -b)→ 类型错误 ESLint / Prett