Pearcleaner 项目递归文件搜索功能故障分析与修复

问题背景

Pearcleaner 是一款 macOS 系统清理工具，在 2.6 版本更新中引入了递归搜索应用程序文件的功能。然而部分用户反馈，在 M1 芯片的 Mac 设备上，程序会卡在"Finding application files.."界面无法继续执行。

故障现象

受影响用户报告的主要症状包括：

1. 点击任意应用程序后，界面无限停留在文件搜索状态
2. 无错误提示或崩溃，程序保持响应但无法完成操作
3. 问题在 M1 架构设备上重现率较高

技术分析

开发者通过多轮调试和用户日志分析，最终定位到问题根源在于递归搜索算法的实现细节：

1. 目录遍历逻辑缺陷：原始代码未正确处理 Application Support 目录中的非目录文件项
2. 文件类型过滤缺失：递归搜索未区分常规文件和目录，导致遇到普通文件时处理异常
3. 环境差异影响：开发者测试环境仅包含目录，而用户环境存在混合文件类型

解决方案

修复方案主要包含以下技术改进：

1. 增强文件类型检查：在递归搜索前显式验证项是否为目录
2. 优化遍历逻辑：跳过非目录项，避免无效的文件系统操作
3. 添加调试日志：增强错误追踪能力，便于未来问题诊断

经验总结

此次故障排查过程提供了宝贵的开发经验：

1. 环境多样性测试：需考虑不同用户文件系统结构的差异
2. 防御性编程：对文件系统操作应添加充分的类型检查和异常处理
3. 日志系统价值：详尽的调试日志能显著加速复杂问题的定位

该修复已包含在 Pearcleaner 2.7 版本中，用户反馈问题得到彻底解决。此次事件也展示了开源社区协作解决技术问题的高效模式。