React Native CLI 中 Podfile 搜索性能优化实践

问题背景

在使用 React Native 0.74 及以上版本时，部分开发者遇到了 pod install 命令执行过程中出现"假死"现象。经过深入排查，发现问题出在 React Native CLI 工具搜索 iOS 项目 Podfile 文件的过程中。

问题分析

React Native CLI 在执行 pod install 时会调用 npx @react-native-community/cli config 命令，该命令内部使用 fast-glob 库进行文件搜索。默认情况下，搜索会递归遍历项目目录及其所有子目录，这在某些特定情况下会导致性能问题：

1. 当项目包含深度嵌套的子模块时
2. 当目录结构非常复杂时（如包含原生代码构建系统）
3. 当存在符号链接可能导致循环引用时

技术细节

fast-glob 默认会无限制地递归搜索所有子目录，这在大多数 React Native 项目中是不必要的，因为：

• Podfile 通常位于项目根目录下的 ios/ 子目录中
• 极少数情况下 Podfile 会出现在更深层次的目录结构中
• 无限制的深度搜索会显著增加搜索时间

解决方案

通过为 fast-glob 的搜索深度设置合理上限（如10层），可以显著改善性能：

function findAllPodfilePaths(cwd) {
  return fastGlob.sync('**/Podfile', {
    cwd: unixifyPaths(cwd),
    ignore: GLOB_EXCLUDE_PATTERN,
    deep: 10,  // 新增搜索深度限制
  });
}

优化效果

这一优化带来了以下好处：

1. 避免了在复杂目录结构中的无谓搜索
2. 显著减少了命令执行时间
3. 解决了"假死"问题
4. 保持了功能的完整性，因为绝大多数情况下 Podfile 都位于较浅的目录层级

最佳实践建议

对于 React Native 项目：

1. 尽量保持 Podfile 在标准位置（项目根目录/ios/Podfile）
2. 避免在项目中创建过深的目录结构
3. 定期检查项目中的符号链接
4. 对于包含大量子模块的项目，考虑使用更扁平化的结构

这一优化已被合并到 React Native CLI 的主干代码中，将帮助开发者避免类似的性能问题。