节点名称在 Clash 配置里通常是 YAML 标量。解析失败时,先区分是流格式不良,还是加载后结构与预期不符。YAML 加载的第一步是解析呈现流,输入格式不良就会失败。名称里的井号、冒号、短横线、引号、括号等若按 plain 样式书写,可能被当成指示符,而不是名字的一部分。
适用条件
适用于某条节点名含标点或空白、整份配置无法加载,或仅在改名后开始失败的情况。适用于能打开文本并对照 YAML 1.2.2 指示符的场合。不适用于订阅未能下载。名称难读并不等于解析失败。
排查步骤与判断依据
- 确认失败是否发生在解析阶段。规范指出解析会因格式不良的输入失败。若文件在加入特殊字符名称之前可加载、之后不可,优先查该标量是否被提前结束。
- 按字符的结构角色缩小范围。映射用冒号加空格分隔键和值;井号开启注释,其后到行末不再是名称。行首的短横线加空格会变成序列条目。flow 样式里的逗号、方括号、花括号会结束当前标量。名称里若出现这些组合且未加引号,应判断为结构被切开,而不是名称本身不被允许。
- 把名称改成带引号的 flow 标量后再加载。不需要转义时用单引号;需要转义序列时用双引号。单引号字符写成两个单引号。规范示例用单引号包住以井号开头的文本,加载后井号属于字符串。
- 名称若必须包含真实换行,不要依赖会折叠换行的 flow 标量,应改用 | 字面块样式。普通一行名称加引号即可。
- 同一名称在引号或块标量中可加载、在 plain 样式中失败,即可认定是指示符冲突。若失败表现为多出来的键、缺字段或后半行消失,优先查冒号加空格与井号,而不是改其它无关段落。
失败时下一步
加引号仍失败,检查是否漏了成对引号,或把文档分隔符三条短横线写进未加引号的行。名称位置上的 & 与 * 可能变成锚点和别名,从而改变表示图,应放进引号以免进入节点属性。仍失败则停止批量替换,回到改名之前的整份流。对照规范中的标量样式逐项修改,不要继续插入更多指示符。