前端构建问题

前端构建失败常见原因包括依赖版本冲突、路径大小写、Node 版本不匹配、静态资源路径错误和 TypeScript 类型错误。

排查流程

flowchart TD
    A[构建失败] --> B[读取第一条有效错误]
    B --> C{依赖错误还是代码错误}
    C -- 依赖错误 --> D[检查 lock 文件和 Node 版本]
    C -- 代码错误 --> E[定位具体文件和行号]
    D --> F[重新安装依赖]
    E --> G[修复导入/类型/资源路径]
    F --> H[重新构建]
    G --> H

常见问题

现象	处理
模块找不到	检查依赖是否安装、路径大小写是否正确
TS 类型报错	按类型提示修正，不建议直接关闭检查
资源 404	检查 public 路径和打包 base
构建内存不足	调整 Node 内存或拆分大模块
本地成功 CI 失败	检查系统差异和锁文件

建议

构建日志要从第一条错误开始看，后续错误可能都是连锁反应。修复依赖问题前先确认是否有人改了 lock 文件。