Periphery项目中的文件删除后扫描问题解析

问题现象

在使用Periphery 3.0.0版本进行代码扫描时，开发者遇到了一个典型问题：当删除一个被标记为未使用的文件后，再次运行扫描命令会出现"No such file or directory"错误。具体表现为：

1. 首次运行periphery scan命令成功识别出未使用的代码文件
2. 删除该未使用文件后，再次运行扫描命令报错
3. 错误信息指向已删除的文件路径

问题根源

这个问题源于Periphery 3.0.0版本的工作机制变化。与2.x版本不同，3.0.0版本在扫描过程中会缓存构建信息以提高性能。当文件被物理删除后，缓存中仍然保留着对该文件的引用，导致后续扫描时工具尝试访问已经不存在的文件路径。

解决方案

目前有两种可行的解决方案：

1. 清除缓存：手动删除Periphery的缓存目录

   rm -rf ~/Library/Caches/com.github.peripheryapp
   

   这种方式会彻底清除所有缓存数据，确保下次扫描从头开始构建。

2. 使用清理构建选项：在扫描命令中添加--clean-build参数

   periphery scan --clean-build
   

   这种方式会在每次扫描前自动清理构建缓存，确保获取最新的项目状态。

最佳实践建议

基于这个问题的分析，建议开发者在以下场景中使用--clean-build选项：

1. 在CI/CD流水线中运行Periphery扫描时
2. 在删除文件后立即进行验证扫描时
3. 当项目结构发生重大变化时

对于日常开发中的常规扫描，可以省略该选项以获得更快的扫描速度，因为缓存机制确实能显著提升重复扫描的性能。

技术背景延伸

Periphery这类静态分析工具的工作原理通常包括几个关键步骤：

1. 项目检查：解析项目结构和配置文件
2. 构建：编译项目以获取完整的符号信息
3. 索引：建立代码元素之间的关系图
4. 分析：基于索引结果识别未使用的代码

缓存机制主要作用于构建和索引阶段，保存中间结果可以避免重复工作。然而，这也带来了与物理文件系统状态同步的挑战。理解这一机制有助于开发者更好地使用工具并解决类似问题。