最常触发解析失败的字符
| 字符或片段 | 常见来源 | 修法 |
|---|---|---|
// | 从教程复制注释 | 删除注释 |
| 末尾逗号 | 手工编辑数组 | 删除最后一项逗号 |
“server” | 中文输入法 | 改成英文双引号 |
<html> | 订阅返回网页 | 换 JSON 输出入口 |
电脑端怎么做最小检查？
安装 sing-box 后执行 sing-box check -c config.json。它会给出字段和位置，比手机端弹窗可靠。
如果文件很长，先保留一个 mixed inbound 和一个 direct outbound，确认框架能启动，再逐段加回 DNS、route 和节点。
为什么从 Clash 配置转来容易坏？
Clash/Mihomo 常用 YAML，sing-box 使用 JSON。缩进、数组、对象和字段名都不同，不能把 YAML 直接改扩展名。
订阅转换后仍要看 inbounds、outbounds、route、dns 是否符合 sing-box 文档。跨客户端切换时，多格式测试订阅源比手工改字段更省错。
Android 和 iOS 有什么差异？
Android 端常见问题是导入剪贴板时丢字符。iOS 端更多是从文件 App 导入时拿到旧版本文件。
两端都建议先用电脑生成通过 check 的 JSON，再通过文件导入，不要在手机上直接改长配置。
修复后的验证方法
sing-box check 返回 Configuration is valid，客户端启动后日志不再出现 parse config。再打开本地代理端口，访问一个普通 HTTPS 网站测试规则命中。
排查注意事项
改配置前备份原文件，保留客户端版本、内核版本和错误日志。正文未覆盖的系统版本，以维护者文档和 Release 说明为准。
sing-box invalid character的工单材料
改配置前备份原文件，保留客户端版本、内核版本和错误日志。路由器、NAS、手机和桌面端的权限模型不同，不能把同一条命令直接搬过去。
协议兼容、规则集和订阅格式会随着客户端更新变化；正文没有覆盖的系统版本，应以维护者文档和当前 Release 说明为准。
sing-box invalid character这类工具页要把工单材料、回退入口和Release 来源写清楚。安装包只从维护者仓库、Release、应用商店或系统包源获取，生产设备只保留可追溯来源。