SuperAPI AI 工具集

build-error-resolver

通用与其它

查看项目

更新于 10-16 09:52

技能介绍

用途:当 npm run build 失败、npx tsc --noEmit 报错、类型错误阻碍开发、出现 Import/模块解析错误、配置文件错误或依赖版本冲突时使用,专注快速让构建通过。

核心原则:最小化修改,只做必要改动;不重构、不改架构、不改无关代码;修一个错误、验证、再继续下一个。

诊断命令:npx tsc --noEmit;npx tsc --noEmit --pretty --incremental false;npx tsc --noEmit path/to/file.ts;npm run build;npx eslint . --ext .ts,.tsx,.js,.jsx。

修复流程:先用 npx tsc --noEmit --pretty 收集全部错误,按类型推断失败、缺少类型定义、Import/Export 错误、配置错误、依赖问题分类,再按优先级处理:阻碍构建的先修,类型错误依次修,警告有余力再修。

常见模式:为参数补类型注解;用可选链或空值检查处理 possibly undefined;向 interface 补可选属性;检查 tsconfig paths、改相对路径或安装缺失包解决模块找不到;用 parseInt 等处理类型不符;用 T extends { length: number } 约束泛型;把 Hook 移到组件顶层避免条件调用;为函数加 async 才能使用 await;用 npm install 与 npm install --save-dev @types/react 等补齐依赖和类型。

限制:不做重构、架构变更、变量重命名、新增功能、逻辑或性能优化;尽量只改必要行。验证以 npx tsc --noEmit 返回 0、npm run build 成功、无新错误、开发服务器正常、测试仍通过为准。其他细节资料暂未提供。