必须用Xcode编译的.app文件(非.ipa)通过xcrun simctl install booted命令安装到已启动的模拟器,路径需加英文双引号;未启动模拟器或路径错误将报“No such file or directory”等错。

要在Mac上的Xcode iOS模拟器中安装APP进行调试,必须使用Xcode编译生成的.app文件(非.ipa),通过simctl命令行工具精准注入到已启动的模拟器中;拖拽、双击或App Store方式全部无效,且环境未就绪时会直接报错“Invalid bundle”或“No such file or directory”。
确认模拟器已启动并处于booted状态
打开Xcode → 顶部菜单Window → Devices and Simulators → 切换到“Simulators”标签页 → 找到目标设备(如iPhone 15 Pro (iOS 18.2)),右侧状态必须显示【Booted】。若为Shutdown,需先选中该设备 → 点击右下角三角形▶按钮启动。
不启动就执行安装命令,终端将返回Error Domain=NSPOSIXErrorDomain Code=2 “No such file or directory”,说明simctl找不到运行中的目标设备。
获取Xcode编译出的.app文件路径
方法一:Xcode内快速定位
在Xcode中完成Product → Build后 → 按住Option键 → Product → Show Build Folder in Finder → 进入Build → Products → Debug-iphonesimulator → 找到与项目同名的xxx.app文件。
方法二:终端精准查找(推荐)
打开终端,执行:find ~/Library/Developer/Xcode/DerivedData -name "*.app" -type d | grep -i "Debug-iphonesimulator"
它会列出所有模拟器架构下的.app路径,复制最后一行完整路径(含空格需加英文双引号)。
【注意】.ipa文件无法安装到模拟器,只接受Xcode针对simulator架构编译的.app包;用Ad Hoc或企业签名的.ipa拖入会静默失败,无任何提示。
用xcrun simctl安装APP到模拟器
第一步:验证xcrun可用性
终端输入xcrun simctl list devices,若提示command not found,请先执行:sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
第二步:执行安装命令
在终端中输入:xcrun simctl install booted "/Users/你的用户名/Library/Developer/Xcode/DerivedData/项目名-随机串/Build/Products/Debug-iphonesimulator/项目名.app"
⚠️路径中含空格或中文时,必须用英文双引号包裹;末尾不能有斜杠/,否则报错code=22。
第三步:确认安装结果
命令执行后无任何输出即为成功。回到模拟器主屏幕,向右滑动或下拉搜索,即可看到新图标出现。


















