Clash 规则若按 YAML 块序列书写,每一项需要短横线加空格。漏写这条指示符时,处理器不会自动补成列表项,而会按映射、标量或格式不良去解释。线索来自节点种类是否变化、映射键是否仍唯一、以及序列长度是否对得上,而不是某一句客户端提示原文。
适用条件
适用于改规则列表后结构异常、怀疑某行少了行首短横线的场合。适用于能对照改前文本,并且能够加载或明确看到加载失败的场合。不适用于 YAML 结构完好、只是规则命中结果不符合预期的情况。依据 YAML 1.2.2 对序列、映射、缩进和格式不良流的规定。
常见线索与判断依据
- 本应是序列的节点变成了映射。规范把序列定义为有序条目,把映射定义为无序且键唯一的关联。父键下面如果直接出现带「冒号加空格」的字段、而没有任何「- 」,加载后该值种类是映射不是序列。判断:检查该键的值节点种类。
- 出现重复键。列表项常常自身是映射,多项会使用相同键名。漏掉后一项的短横线时,后一项的键会写进前一项的映射里,于是同一映射出现两个相同键。判断:键名冲突,或后写的同名键把前一项字段挤掉。
- 后续行从属关系错位。块集合靠缩进确定范围。少了短横线后,下一行可能变成上一键的值、上一映射的另一个键,或因缺少分隔而无法解析。判断:新增内容的父节点不是目标序列。
- 多行文本不再是多条条目。规范示例在键下列出多名队员时,每一名都有自己的短横线。去掉这些短横线只留下若干行普通文本,该值不再是序列,而可能变成一个跨行标量;flow 标量跨行时换行还会被折叠,看起来像还在、条目数却已经不是多项。
- 解析失败。解析会因格式不良的输入失败。行首既没有短横线、又没有作为映射键的冒号,同时缩进也不属于块标量时,往往直接组不成序列化树。若该列表本来写成方括号,漏的是逗号或括号,线索不在短横线,不要混查。
失败时下一步
先在同一缩进层级数短横线,再加载看序列长度是否一致。种类已经变成映射时,不要继续往该映射里堆字段来补规则,应给每一项补上「- 」,并把属于该项的键写在短横线之后、缩进更深的位置。若加载失败,回到改前整份流,每次只恢复一行短横线再试。注释和空行不是条目,不能用来判断有没有漏写。