如何在通过USB-C连接的iPhone上运行Expo项目（macOS环境）

前置准备 #

• 确保iPhone已开启开发者模式：iOS 16+ 前往「设置-隐私与安全性-开发者模式」开启；旧版本iOS 前往「设置-通用-开发者选项」开启（若未显示，需先连接Xcode触发）。
• 安装Xcode（需包含iOS开发组件，首次打开需同意许可协议并完成组件安装）。
• 用认证的USB-C转Lightning/USB-C to USB-C数据线连接iPhone与Mac，iPhone端选择「信任此电脑」并输入锁屏密码确认。

验证设备连接 #

打开终端执行以下命令，确认设备被系统识别：

idevice_id -l

若输出你的iPhone设备ID，说明连接正常。

运行项目到iPhone #

根据你安装的CLI版本，选择对应命令：

1. 使用新版@expo/cli（官方推荐）：

npx expo run:ios --device

该命令会自动识别连接的iPhone，编译项目并完成安装。

2. 使用旧版expo-cli：

expo start --device

启动后在iPhone的Expo Go应用中扫描终端显示的二维码，即可加载项目（USB连接下无需依赖同一网络，稳定性更高）。

解决签名/权限问题 #

• 打开Xcode，进入「Settings > Accounts」添加你的Apple ID（个人账号可免费用于开发签名）。
• 进入项目ios目录，打开.xcworkspace文件，选择连接的iPhone为运行目标，在「Signing & Capabilities」面板中选择你的Apple ID作为Team，Xcode会自动生成签名证书与配置文件。
• 若iPhone提示「无法验证应用」，前往「设置-通用-VPN与设备管理」，找到对应Apple ID的证书并点击「信任」。

常见问题排查 #

• 设备不被识别：重启Mac与iPhone，更换官方认证数据线，确保Xcode已完成组件安装。
• 命令报错「找不到设备」：检查Xcode是否已打开并同意许可协议，确认iPhone开发者模式已开启。
• Expo Go版本不兼容：从App Store下载对应版本的Expo Go（expo 48.0.x对应Expo Go 2.28.0及以上）。

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