使用react-native init创建项目后运行iOS出现应用未注册错误

AI 小北

2026-5-15

解决React Native运行iOS时"React Native Application has not been registered"错误

嘿，这个错误我碰到过好多次了，大概率是几个常见的小问题导致的，我给你一步步排查解决：

先检查当前目录是否正确！你用react-native init AwesomeProject创建的项目，根目录是AwesomeProject，但你执行了cd Route——这明显是进错目录了！先切换到正确的项目目录：
```
cd AwesomeProject
```
然后再重新运行react-native run-ios试试，这可能是最直接的解决办法。
确认AppRegistry注册名称和项目一致
打开项目根目录下的index.js（如果是旧版本React Native可能是index.ios.js），找到AppRegistry.registerComponent这一行，确保第一个参数是你创建项目时的名称AwesomeProject，比如：
```
AppRegistry.registerComponent('AwesomeProject', () => App);
```
同时打开Xcode里的项目配置文件Info.plist，找到CFBundleName字段，确认它的值也是AwesomeProject，必须和代码里注册的名称完全匹配。
清除React Native缓存
有时候缓存会导致这类注册不匹配的问题，执行以下命令重置缓存：
```
npm start -- --reset-cache
# 如果你用yarn的话，换成这个
yarn start --reset-cache
```
缓存重置完成后，再重新运行react-native run-ios。
重置模拟器或重装依赖
如果上面的方法都没用，可以试试重置iOS模拟器：打开模拟器后，点击菜单栏的Hardware > Erase All Content and Settings，清空模拟器数据后再运行项目。
或者删除依赖重新安装：
```
rm -rf node_modules
npm install
```
安装完成后再启动项目。