导读：
Shadowrocket脚本功能通过JavaScript实现请求重写与数据修改,适用于API调试、广告过滤等场景，本文详解脚本配置流程、路由模式选择及常见问题排查，助你构建高效的国际网络加速环境。
Shadowrocket脚本功能的核心价值
Shadowrocket脚本功能基于JavaScript引擎,允许用户在请求发送前或响应返回后执行自定义逻辑，对于需要频繁调试API接口的跨境办公场景，或是需要优化学术资源访问体验的开发者，这一功能提供了比传统规则更灵活的流量处理能力。
配置流程详解
启用脚本模块
进入配置编辑界面,找到[Script]字段，若使用外部订阅，确保订阅链接包含脚本资源，手动添加脚本需遵循以下格式：
[Script]
脚本名称 = type=http-request,pattern=^https?:\/\/api\.example\.com,script-path=local/script.js,requires-body=true脚本存放路径
将.js文件放入iCloud Drive/Shadowrocket/目录，或使用手机本地存储，脚本路径在配置中引用时，使用local/前缀表示本地文件。
调试与日志查看
开启设置中的"日志记录"功能，脚本执行异常时可在"最近请求"中查看详细报错，建议先用简单console.log测试脚本是否被正确加载。
全局路由模式深度解析
Shadowrocket脚本功能生效的前提是正确理解全局路由的四种工作模式：
配置模式（Config） 根据规则列表自动分流，脚本仅对匹配规则的请求生效，适合大多数国际网络加速需求，兼顾速度与精准度。
代理模式（Proxy） 所有流量强制走代理节点，脚本处理全部HTTP/HTTPS请求，适用于需要全局调试的开发环境，但可能增加节点负载。
直连模式（Direct） 流量不经过代理，脚本仅在本地执行，适合仅需要重写请求、无需国际网络加速的纯本地调试场景。
场景模式（Scene） 基于地理位置或网络环境自动切换上述三种模式，例如连接公司WiFi时自动切换为直连，移动数据下启用代理。
实战脚本示例
以下脚本用于优化学术资源访问时的请求头设置：
// academic-header.js
const modifiedHeaders = $request.headers;
modifiedHeaders['User-Agent'] = 'Mozilla/5.0 (AcademicAccess/1.0)';
modifiedHeaders['Accept-Language'] = 'en-US,en;q=0.9';
$done({headers: modifiedHeaders});
配置引用：
学术优化 = type=http-request,pattern=^https?:\/\/scholar\.example\.com,script-path=local/academic-header.js对于需要稳定运行脚本功能的用户,建议选择支持TCP/UDP全协议转发的优质节点，部分高端专线服务商提供针对API调试优化的低延迟线路，可显著提升脚本响应速度。
常见问题排查
现象：脚本配置后无效果，日志显示"Script not found"
原因：文件路径错误或iCloud同步延迟导致Shadowrocket无法读取本地文件。
解决方法：检查脚本路径是否以local/开头；将文件移出iCloud，放入"我的iPhone/Shadowrocket"本地目录。
现象：脚本执行但请求超时 原因：脚本处理逻辑耗时过长，或节点连接不稳定。 解决方法：优化脚本代码，避免同步阻塞操作；切换至延迟更低的跨境办公专用节点。
现象：部分HTTPS请求脚本不生效 原因：证书未正确安装，或域名未开启MITM（中间人攻击）解密。 解决方法：在"配置-HTTPS解密"中添加目标域名；确保已安装并信任Shadowrocket的根证书。
进阶优化建议
Shadowrocket脚本功能与规则系统配合使用时,建议将高频匹配的脚本规则置于规则列表顶部，对于需要长期稳定运行的跨境办公环境，选择提供BGP线路的节点服务商能确保脚本在复杂网络环境下的执行稳定性。
定期清理脚本日志缓存可避免内存占用过高,在"设置-高级"中开启"自动清理日志"功能，保持设备运行流畅。
