Pearcleaner 中 Application Scripts 目录显示问题的技术分析

问题背景

在 macOS 系统清理工具 Pearcleaner 中，用户报告了一个关于应用程序脚本目录显示不一致的问题。具体表现为：在首次扫描某些应用程序时，~/Library/Application Scripts/[bundle id] 目录项不会立即显示，需要刷新后才能出现。

问题现象

该问题主要出现在 macOS Ventura 13.0.1 至 14.1 版本中，但在更高版本如 14.6 及 15.0 beta 中不再复现。问题影响范围较广，涉及约半数已安装的应用程序。

技术分析

经过深入调查，发现问题根源在于 Pearcleaner 的文件搜索逻辑与 macOS 系统 API 的交互方式。具体技术细节如下：

1. 触发机制：当 Pearcleaner 调用 FileManager.default.containerURL 方法获取应用程序的容器目录时，macOS 系统会隐式创建必要的文件夹结构，包括 Application Scripts 目录。

2. 时序问题：原始代码中，文件搜索逻辑先扫描现有文件，再检查容器目录。这种顺序导致 Application Scripts 目录在首次扫描时尚未被系统创建，因此无法被发现。

3. 版本差异：该行为在不同 macOS 版本中存在差异，Ventura 和早期 Sonoma 版本表现明显，而后续版本中系统行为有所改变。

解决方案

开发者采用了以下修复方案：

1. 调整搜索顺序：将容器目录的检查提前到文件搜索之前，确保系统有足够时间创建必要的目录结构。

2. 逻辑重组：重构了 AppPathsFetch.swift 文件中的搜索逻辑，优化了文件系统访问的顺序。

该修复方案已通过测试验证，在 macOS 13.0.1 至 14.1 版本中均能正确显示 Application Scripts 目录。

技术启示

这个案例揭示了几个重要的技术要点：

1. 系统 API 的副作用：某些看似只读的系统 API 调用可能会产生写入操作，开发时需要考虑这些隐式行为。

2. 版本兼容性：macOS 不同版本间系统行为的差异需要特别关注，特别是在文件系统相关操作上。

3. 调试技巧：对于这类时序敏感的问题，调整操作顺序往往能提供有效的解决方案。

该问题的解决不仅提升了 Pearcleaner 的可靠性，也为类似工具的开发提供了有价值的参考经验。