按故障现象分类，
而不是从头猜。

「添加订阅」只是记下了这个链接，本身不会自动拉取节点。需要再点进这条订阅条目，点一次「更新」，Shadowrocket 才会真正去访问链接、抓取节点数据。这是最常被误认为「导入失败」的一步。

按顺序排查：① 订阅链接是否已过期或达到流量上限，需联系订阅服务商确认；② 复制链接时是否带了多余的空格、换行或被截断，重新复制一次确认是完整的一行；③ 用浏览器直接打开这个链接，看返回的是正常的节点数据，还是登录页 / 错误页 / 空白页。

如果开启了 iCloud 自动同步，节点数据会保留一份 iCloud 端记录，仅在本机删除不会清除这份记录。需要进入 Data → iCloud，找到对应服务器节点，删除 iCloud 端的备份和同步记录才能真正生效。

常见原因是屏幕反光或二维码本身分辨率不够——把显示二维码的屏幕亮度调到最高，摄像头稍微拉远一点对焦，通常能解决。如果反复失败，改用复制链接手动粘贴的方式更稳妥。

通常是当前选中的节点连接超时。回到节点列表，点右上角「测速」图标重新测一遍延迟，换一个延迟正常（绿色/黄色）的节点重试，不代表软件本身出了问题。

多数是当前节点不稳定或服务器端异常，先切换到延迟较低的其他节点重试；如果订阅里所有节点都出现同样情况，大概率是订阅服务商那边的问题，需要联系对方确认服务器状态，客户端本身无法解决。

可能是之前误点了「不允许」。进入系统「设置 → 通用 → VPN与设备管理」，检查是否已经存在 Shadowrocket 相关的 VPN 配置记录并处于关闭状态，或者删除已有记录后重新打开 Shadowrocket 触发一次新的授权请求。

如果手机长时间处于「低电量模式」，iOS 系统可能会限制后台网络活动，导致连接被动断开——这是系统省电策略，不是软件故障。如果需要连接稳定性优先，可以关闭低电量模式，或在系统「电池」设置里为 Shadowrocket 调整相关限制。

先切换 Wi-Fi 和蜂窝网络分别测试一次，排除当前网络本身的问题；再确认订阅是否已过期。如果依然全部超时，把 设置 → 延迟测试方法 改成 CONNECT 方式重新测试，这种方式比默认方式更接近真实连接过程，测出来的结果参考价值更高。

如果测速时全局路由处于 Configuration 模式，测速请求本身可能被规则判定为直连（比如测速用的域名恰好被配置成 DIRECT），导致测出来的延迟其实没有经过节点。建议测速前临时切换到 Proxy 模式，测完再切回来，避免规则干扰。

延迟反映的是「连接建立的响应速度」，不代表带宽或实际吞吐量。延迟低但速度慢，通常是节点带宽被多人共用导致拥堵，或者订阅服务商本身的线路质量问题，可以换一个节点对比，如果普遍如此需要联系服务商。

先检查系统「设置 → 你的 Apple ID → iCloud」里是否已经允许 Shadowrocket 使用 iCloud 云盘，以及 iCloud 云盘本身是否已开启；确认网络连接正常。如果设置都正常但仍然同步失败，通常是 iCloud 服务本身临时异常，可以尝试手动删除 iCloud 备份后重新同步一次。

进入 Config 页面，点击「恢复默认配置」，即可还原到内置的 default.conf 默认规则文件。恢复后再重新叠加自己需要的自定义规则，建议每次只改一小部分并测试，避免一次性大幅修改导致难以定位问题。

如果开启了「保存到 iCloud」，先检查系统 iCloud 设置里 Shadowrocket 的 iCloud 云盘权限是否正常；再用系统「文件」App 打开 iCloud 云盘里的 Shadowrocket 目录，确认 Modules 文件夹内文件是否处于「未下载」状态（iCloud 本地缓存被清理时会这样），等待自动下载或手动点击下载即可恢复。