移动React Native项目路径后运行run-ios出现bundle加载失败问题
2026-5-28
解决React Native项目复制后
react-native run-ios Bundle加载失败问题 我之前也碰到过一模一样的情况——把RN项目复制到新目录折腾一圈切回原路径，结果bundle加载还是报错。这大多是路径变动后残留的缓存和配置在搞鬼，试试下面这些分步操作：
1. 彻底清理React Native核心缓存
先把RN的全局和本地缓存清干净，这是最关键的一步：
- 清除watchman缓存：
watchman watch-del-all - 删除node_modules并重新安装依赖：
rm -rf node_modules && npm install - 重置Metro打包缓存，启动时加上参数：
npm start -- --reset-cache
2. 清理iOS端的构建残留
Xcode和CocoaPods会记住旧路径的缓存，必须彻底清除：
- 先关闭Xcode，然后删除Xcode派生数据：
rm -rf ~/Library/Developer/Xcode/DerivedData - 进入项目的ios目录，删除Pods文件夹和Pod锁定文件：
cd ios && rm -rf Pods Podfile.lock - 重新安装Pods依赖：
pod install - 回到项目根目录，删除iOS的build文件夹：
rm -rf ios/build
3. 检查项目中的硬编码路径
有些项目会在配置文件里硬编码原路径，哪怕切回原路径也可能有错误：
- 打开
ios/[你的项目名称].xcodeproj/project.pbxproj文件，搜索旧路径（如果之前复制到过其他目录），确认所有路径都指向当前项目的正确位置 - 如果用了环境变量（比如
.env文件），检查里面有没有包含路径相关的配置项，确保和当前路径匹配
4. 重启所有相关服务
- 彻底关闭Metro服务（终端按
Ctrl+C退出），关闭iOS模拟器 - 先启动Metro：
npm start，等Metro加载完成、显示Loading dependency graph...后，再执行react-native run-ios
要是上面的步骤都试过还是不行，可以试试删除package-lock.json（用yarn的话是yarn.lock），重新执行npm install，然后再重复一遍缓存清理的流程。
内容的提问来源于stack exchange，提问作者Nomura Nori
相关产品推荐
相关产品推荐
