xcode真机无线调试需按“先有线配对、再无线激活、最后断线验证”三步操作，前提包括xcode≥9.0、ios≥11.0、同wi-fi、开启开发者模式、信任mac、设置锁屏密码。
只要满足基础条件，xcode 真机无线调试并不难设置，关键是步骤顺序和细节不能错。核心是“先有线配对、再无线激活、最后断线验证”，跳过任一环节都可能失败。
前提条件必须达标
无线调试不是点一下就能用的功能，它有硬性门槛：
- Xcode 版本 ≥ 9.0（推荐使用最新稳定版，如 Xcode 15.x 或 16.x）
- iOS 设备系统 ≥ 11.0（目前主流设备基本都满足）
- Mac 和 iPhone 必须连接同一个 Wi-Fi 网络（注意：部分企业/校园网络启用了客户端隔离，会导致无法通信）
- iPhone 已开启“开发者模式”（iOS 16.4+ 要求：设置 → 隐私与安全性 → 开发者模式 → 打开并重启）
- iPhone 已信任当前 Mac（首次有线连接时弹出“信任此电脑”提示，需手动确认）
- iPhone 设置了锁屏密码（无密码设备无法启用无线调试，这是系统强制安全策略）
配置流程分三步走
整个过程必须按顺序操作，尤其注意“断线时机”：
-
第一步：有线连接并打开设备管理器
用数据线连接 iPhone 与 Mac，启动 Xcode，菜单栏选择 Window → Devices and Simulators（快捷键 ⇧⌘2） -
第二步：勾选无线连接并确认标识
在左侧 Devices 列表中找到你的设备，勾选右侧的 Connect via network。稍等几秒，设备名旁应出现地球图标 ?；若没出现，说明未就绪，别急着拔线 -
第三步：断线后补输 IP 地址（关键！）
拔掉数据线 → 回到 Devices and Simulators 窗口 → 右键点击该设备 → 出现 Connect via IP Address 选项（不拔线不会显示此项）→ 输入 iPhone 的局域网 IP（设置 → 无线局域网 → 当前网络右侧 ⓘ → 查看 IP 地址）→ 点击 Connect
常见卡点与应对方法
很多问题其实源于小疏忽，而不是功能失效：
- 右键没有 Connect via IP Address？ —— 检查是否已拔掉数据线；未拔线时该选项被隐藏
- 地球图标一闪就消失？ —— 确认 Wi-Fi 是否同一网络，关闭 Mac 防火墙临时测试；路由器开启 AP 隔离也会导致断连
- 运行时报 “The device must have a passcode set”？ —— 立即去 iPhone 设置里设一个锁屏密码（数字或字母均可，纯滑动解锁不行）
- 设备列表里看不到真机？ —— 在 Xcode 顶部 Scheme 位置点击设备名下拉框，确保勾选了 Show as Run Destination（在 Devices and Simulators 窗口右下角）
- 偶尔断连或编译慢？ —— 保持 iPhone 电量 ≥ 30%，避免进入低电量模式；Wi-Fi 信号强度建议 ≥ 3 格
后续使用很简单
完成一次配置后，只要 Mac 和 iPhone 在同一 Wi-Fi 下，且 iPhone 未重置网络设置或取消信任，之后开机即可直接出现在 Xcode 运行目标列表中，带 ? 标识。无需重复连线，也不用每次输 IP。
如果某天突然失效，优先尝试：iPhone 重启 + Mac 重启 + 重新信任电脑，比从头配置更快。
