必须先在iPhone设置中开启Safari高级里的Web检查器,再在Mac Safari设置中启用开发菜单,通过USB连接并等待设备识别后,才能启动远程调试会话,实时修改样式、查看网络请求、调试JavaScript。

你需要在Mac上实时查看并修改iPhone Safari中打开的网页样式、控制台报错、网络请求或JavaScript执行逻辑,而不是靠猜或模拟器反复试错。
开启iPhone端Web检查器
这一步必须在手机上完成,否则Mac端根本识别不到设备。进入设置→Safari→高级→打开【Web检查器】开关。注意:iOS 17.4及以上版本该选项默认关闭,且不随系统语言变化位置——始终在“高级”最底部。
打开后无需重启Safari,但必须确保后续操作时iPhone已连接Mac且Safari正在前台运行目标网页。
启用Mac端Safari开发者菜单
点击左上角Safari→设置→高级→勾选【在菜单栏中显示“开发”菜单】。这步漏掉,整个远程调试路径就断了,菜单栏不会出现“开发”项,后续所有选项都不可见。
勾选后立即生效,不用重启浏览器。如果没看到“开发”,请确认不是点错了“隐私”或“网站”标签页。
物理连接与设备识别
用原装或MFi认证USB线将iPhone连接Mac。确保iPhone已解锁并信任此电脑(首次连接会弹出提示,点“信任”)。
在iPhone Safari中打开你要调试的网页,保持该标签页为当前活动页。
回到Mac,打开Safari,点击菜单栏“开发”。等待3~5秒,底部会出现你的iPhone设备名(如“张三的iPhone”)。若长时间不出现,拔插一次USB线再等——这是最常见的卡点,不是设置问题,是USB握手延迟。
启动远程调试会话
点击“开发”→你的iPhone设备名→选择对应网页标题(例如“https://example.com”)。网页检查器会立刻在Mac端弹出,界面和本地调试完全一致。
此时你可直接编辑HTML结构、实时改CSS样式、在“控制台”里执行JS命令、在“网络”标签页查看XHR请求头与响应体、在“资源”里看localStorage内容。所有操作都会即时反映在iPhone屏幕上。
特别注意:点击检查器左上角的手型图标(Touch to inspect),然后用手指在iPhone屏幕上轻点任意元素,Mac端检查器会自动高亮并跳转到对应DOM节点——这对定位移动端隐藏按钮或小尺寸触控区极其高效。
将包含oralBroadcastingList、materialList、bgmInfo等字段的JSON视频素材转换为剪映API可用的自然语言描述,用于生成视频制作指令,包括素材匹配、时间轴计算、字幕同步、特殊效果处理等。
调试WebView内嵌网页(iOS App场景)
方法一:App需启用调试支持
在Xcode中运行App前,在Scheme → Run → Arguments → Environment Variables里添加WEB_INSPECTOR_ENABLED=1;或让开发同事在代码中调用[[NSUserDefaults standardUserDefaults] setBool:YES forKey:@"WebInspectorEnabled"];。否则Safari开发菜单下不会列出该WebView进程。
方法二:真机环境快速验证
确保iPhone已开启Web检查器→启动含WebView的App→加载目标网页→Mac Safari开发菜单中查找设备名下方是否出现“AppName”条目。若有,点击即可调试;若无,说明该WebView未暴露调试接口,需回归方法一配置。
注意:iOS 16起,部分企业签名App默认禁用WebView调试,即使设置了环境变量也无效,必须重签名并注入调试权限。
强制注入CSS覆盖原始样式
第一步:在远程调试会话中,切换到“资源”标签页,右键任意CSS文件(如main.css)→选择“设置为本地覆盖”→指定一个本地空文件夹(如~/Desktop/safari-overrides)。
第二步:双击该CSS文件进入编辑器,在末尾添加你的规则,例如:
body { margin: 0 !important; }
.btn { padding: 12px 24px !important; }
第三步:按Command+S保存,刷新iPhone页面。修改将立即生效且持久化——下次打开同一网址仍保留该样式,无需重复操作。
关键提醒:覆盖目录路径不能含中文、空格或特殊符号,否则Safari会静默失败,控制台也不报错,样式就是不生效。
打断点调试JavaScript
第一步:在检查器中切换到“调试器”标签页,左侧资源树展开js文件,点击行号左侧灰色区域设置断点。
第二步:在iPhone上触发对应交互(如点击按钮),Mac端会自动暂停执行,高亮当前行,并显示作用域变量、调用栈和控制台输入框。
第三步:使用右侧调试工具栏的▶️(继续)、▷▷(跳过)、↓(步入)、↘(步出)逐行执行。悬停变量名可查看实时值,右键可“复制值”或“在控制台中求值”。
第四步:若想捕获未处理异常,在调试器顶部勾选“暂停在未捕获异常”,之后任何JS报错都会自动中断,方便定位源头。

















