执行make gen_kit命令报错，构建脚本异常如何解决？

以下是针对make gen_kit执行时出现构建脚本异常的具体解决步骤：

• 清理子包构建缓存
  进入chess_ui_kit包目录，彻底清理旧的构建缓存文件：

  cd packages/chess_ui_kit && rm -rf .dart_tool build
  

  之后重新执行依赖拉取：

  flutter pub get
  

  （如果使用FVM，替换为fvm flutter pub get）

• 统一build_runner版本
  检查根项目和chess_ui_kit子包的pubspec.yaml中build_runner的版本是否一致，版本不匹配是常见冲突原因。将子包的build_runner版本调整为和根项目相同，或执行以下命令更新到兼容当前Flutter版本的最新版：

  cd packages/chess_ui_kit && flutter pub upgrade build_runner
  

• 排查构建器配置问题

  1. 若chess_ui_kit目录下存在build.yaml，检查文件是否有语法错误、过时的构建器声明或重复配置。
  2. 确认pubspec.yaml的dev_dependencies中已正确引入所需构建器（如json_serializable、freezed等），且配置参数无错误。

• 直接执行构建命令定位具体错误
  跳过Makefile，直接在子包目录执行构建命令，获取更详细的报错信息：

  cd packages/chess_ui_kit && flutter packages pub run build_runner build --delete-conflicting-outputs
  

  根据输出的具体错误（如某构建器版本不兼容、配置缺失）针对性修复。

• 验证Flutter版本兼容性
  确认chess_ui_kit依赖的所有包（尤其是代码生成类依赖）与当前Flutter版本兼容，部分旧依赖可能无法适配新版Flutter，需升级对应依赖包版本。

内容的提问来源于stack exchange，提问作者Hojiakbar