Pod Install安装废弃React引发'React/RCTBridge.h'未找到编译错误

这种RN项目加Pods后出现的头文件找不到+废弃警告的问题我碰到过好多次，大概率是依赖配置冲突、Podfile没正确关联React源码路径，或者新增库和你的RN版本兼容性不匹配导致的。结合你提到的Viro相关依赖，给你一套可行的解决步骤：

1. 检查并修正Podfile配置 #

首先确保你的Podfile正确引入React Native核心依赖，并且关联好新增库的路径。下面是适配你场景的参考配置：

require_relative '../node_modules/react-native/scripts/react_native_pods'
require_relative '../node_modules/@react-native-community/cli-platform-ios/native_modules'

platform :ios, '12.0' # 改成你项目支持的最低iOS版本

target '你的项目名称' do
  config = use_native_modules!

  # 关联React Native核心，确保路径正确
  use_react_native!(
    :path => config[:reactNativePath]
  )

  # 手动添加Viro相关依赖（按照你的podspec路径）
  pod 'ViroKit', :path => '../node_modules/react-viro/ios/dist/ViroRenderer/'
  pod 'ViroReact', :path => '../node_modules/react-viro/ios/dist/ViroReact/'

  # 关键：手动指定React核心组件的路径，避免Pods拉取错误版本
  pod 'React', :path => '../node_modules/react-native/'
  pod 'React-Core', :path => '../node_modules/react-native/'
  pod 'React-RCTBridge', :path => '../node_modules/react-native/Libraries/Bridge'

  post_install do |installer|
    # 执行RN默认的post_install脚本
    react_native_post_install(installer)

    # 给Viro相关target添加React头文件搜索路径，同时可选屏蔽废弃警告
    installer.pods_project.targets.each do |target|
      if target.name == "ViroReact" || target.name == "ViroKit"
        target.build_configurations.each do |config|
          config.build_settings['HEADER_SEARCH_PATHS'] = "$(inherited) $(SRCROOT)/../node_modules/react-native/Libraries/**"
          config.build_settings['CLANG_WARN_INHIBIT_ALL_WARNINGS'] = 'YES'
        end
      end
    end
  end
end

2. 彻底清理缓存后重新安装Pods #

缓存残留是这类问题的常见元凶，执行以下命令彻底清理：

# 删除Pods文件夹和锁文件
rm -rf Podfile.lock Pods
# 清理Xcode派生数据
rm -rf ~/Library/Developer/Xcode/DerivedData
# 更新Pods仓库并重新安装
pod install --repo-update

3. 验证Xcode项目的头文件搜索路径 #

如果上面两步还没解决，手动检查Xcode配置：

• 打开你的iOS项目，选中主target
• 切换到Build Settings标签，搜索Header Search Paths
• 确保包含$(SRCROOT)/../node_modules/react-native/Libraries，并且设置为Recursive（递归搜索）

关于React废弃警告的补充说明 #

你看到的废弃警告是因为新增的库（比如Viro）使用了RN已经标记为废弃的API。如果不想看到这些警告，除了上面Podfile里的屏蔽配置，也可以尝试升级这些库到兼容你RN版本的最新版（如果有更新的话）。

内容的提问来源于stack exchange，提问作者MonkeyBonkey