2.2 KiB
2.2 KiB
Unity资源批量检测工具问题定位对话记录
过程纪要与关键定位步骤
本记录梳理了团队在调试和落地 FileCheckerBatchRunner 批量资源检测工具时的真实排查历程及主要问题定位线路。
关键历程回顾
1. 初步实现与运行、发现无输出/CSV未生成
- 批次运行无报错但也无输出，CSV文件未生成。
- 首步日志分析/Debug.Log加强，发现批处理入口函数已调用但没有实际checker执行。
2. 检查 checker 查找与命名
- 发现 CheckerName 用的是中文（如“中文文件名检查器”），而命令行传的是英文类型名（ChineseFileNameChecker）。
- 优化查找，支持用类型名命令行触发checker。
3. 发现执行成功但导出未生成CSV
- 批处理日志显示调用入口、命中checker都无问题，报告未落盘。
- 定位到ReportExporter中EditorUtility.SaveFilePanel在batchmode下无效，加入isBatchMode逻辑，确保文件名能直接写盘。
- 修正filePath/fileName变量混用、保证导出一致。
4. 修复属性访问、去除反射
- handling等字段由反射访问改为强类型。
- 编译错误由语法误用（花括号/变量名）暴露并修复。
5. checker多Tab及文件后缀精细筛选
- 学习FileCheckerWindow分组TabType和后缀精细筛逻辑，定位单checker全遍历带来的低效结构。
- 增强batch runner算法， checker按tab分组，资源只加载/切换一次，所有相关checker依次调用。
6. 场景类型资源自动还原
- batchmode下场景类检测也实现自动切回原有场景，防止环境被批处理影响。
7. 提示/日志增强与链路打通
- batch脚本自动输出耗时与关键节点辅助提示。
- 所有实现批/编辑器体验对齐，健壮性和扩展性大幅提升。
总结体会
- 调试经历中 “日志粒度/状态同步”最能定位批处理盲点。
- 团队协作下，一切路径/命名/类型都应显式、文档化，减少文化/语言切换二义性。
- UI/CLI/CI多端一致性设计不只是性能提升，更是可靠性大幅提升。
自动生成，供后续类似项目排查与团队分享借鉴。