Xcode真机运行React Native iOS应用时构建旧缓存代码不更新

这个问题的核心原因是：iOS模拟器默认会连接本地运行的Metro打包服务实时拉取最新代码，而真机如果无法正常连接Metro服务，Xcode会直接加载App包内内置的历史静态JS Bundle，不会同步最新代码改动。你之前尝试的清理构建文件夹、删除DerivedData、卸载设备端旧App都只清理了原生编译缓存，没有解决JS缓存和真机-Metro连接的问题，所以无法生效。
按以下优先级逐一排查操作即可解决：

• 先确认网络环境正常：真机和开发电脑必须连接同一个WiFi局域网，电脑端和手机端都暂时关闭VPN、网络代理工具，避免网络拦截导致真机无法访问电脑上的Metro服务。如果Xcode控制台出现Could not connect to development server类报错，优先排查网络问题。
• 全量清理JS侧缓存，不要只清理原生缓存：
  1. 关闭所有正在运行的Metro终端、所有React Native相关的node进程
  2. 进入项目根目录，执行命令启动带缓存清理的Metro服务：

     # npm用户执行
     npm start -- --reset-cache
     
     # yarn用户执行
     yarn start --reset-cache
     

  3. 等待Metro完全启动显示欢迎提示后，再回到Xcode点击Run向真机安装运行应用
• 检查Xcode编译配置是否正确：
  1. 打开Xcode选中项目Target，进入Build Settings页，确认当前运行的Scheme是Debug模式，不是Release模式——Release模式会静态打包JS代码进安装包，不会实时连接Metro更新，每次改代码都需要全量重新编译才会生效
  2. 找到Debug Information Format配置项，确认Debug模式下的值为DWARF，如果选了DWARF with dSYM File会触发静态打包逻辑，直接加载旧Bundle
  3. 进入Build Phases页，展开Bundle React Native code and images阶段，确认Debug模式下的脚本没有被手动修改过，默认配置会自动为真机设置Metro连接地址
• 补全iOS本地网络权限配置：iOS 14及以上系统需要应用申请本地网络权限才能访问同局域网下的Metro服务，打开项目ios/项目名/Info.plist文件，添加以下配置：

  <key>NSLocalNetworkUsageDescription</key>
  <string>访问本地网络加载开发代码</string>
  <key>NSBonjourServices</key>
  <array>
    <string>_metro._tcp</string>
  </array>
  

  缺少该配置时，真机端App无法自动发现本地Metro服务，会直接加载内置旧代码。
• 手动配置Bundle地址验证：App安装到真机后，摇晃设备调出RN开发菜单，选择Configure Bundler Location，不要填localhost/127.0.0.1，手动填入开发电脑在当前局域网下的实际IP（可在电脑网络设置里查看，通常为192.168.x.x格式），端口保持默认8081，保存后选择Reload即可拉取最新代码。
• 兜底操作：以上步骤都无效时，删除项目下的ios/build文件夹，在ios目录下重新执行pod install，重复前面的清Metro缓存步骤后再重新编译运行。

避坑提示：不要通过Xcode直接隐式启动Metro，手动提前执行带--reset-cache参数的Metro启动命令，能避免80%的缓存不更新问题。

内容的提问来源于stack exchange，提问作者Ki-joe