CClash 中文下载站选择客户端 ↗
首页/博客
故障排查

Clash 同一字段写了两次,为什么结果难以判断

Clash 同一字段写了两次,为什么结果难以判断。了解适用条件、操作步骤与常见问题的排查方法。

编辑部 · 更新 2026-10-04

同一字段在 Clash 配置里写了两次,常被理解成后面生效或前面生效。YAML 1.2.2 并不把这种猜测规定为可移植结果。映射在表示里是键到值的无序、唯一关联。键顺序只出现在序列化树中,为的是顺序访问;组成表示图时会丢掉这些序列化细节。因此写了两次之后你看到的值,并不来自规范中的覆盖规则,而来自具体处理器如何对待本应唯一的键。结果难以判断,是因为问题已经超出表示所能保证的范围。

适用条件

适用于文本里同一映射出现两次同名键、有时能加载有时不能、或两次加载得到的值对不上的情况。适用于比较不同环境却无法用规范解释差异的场合。不适用于网络错误。本文只根据 YAML 1.2.2 的信息型号,不描述某一实现内部如何吞掉重复键。

规范如何规定映射

表示图中的映射键必须唯一。Dump 时处理器把无序的键排成序列化顺序;Load 时解析丢掉呈现细节,组成丢掉序列化细节,构造只能使用表示中的信息。键顺序、注释、节点样式、缩进都不得作为构造依据。规范还要求数据在编程语言之间可移植,并匹配动态语言里字典、哈希这类键唯一结构。

两次书写同一个键,并没有在表示里留下两个有序槽位。若处理器拒绝组成,你会得到失败;若仍构造出原生对象,那是该实现的额外选择,规范没有要求其它实现重复这一选择。因此不能从「仍然加载成功」反推规范允许重复键。

为何难以根据文本位置判断

  1. 源码中的上下顺序属于呈现或序列化,不进入表示。不能用行号判断谁覆盖谁。
  2. 块映射与 flow 映射可以表达同一表示。花括号里的重复键与缩进块里的重复键,问题性质相同。
  3. 键相等要看节点,不看字形。未加标签时类型取决于应用:看起来像数字的键与加引号的字符串键可能并不相等,只盯着源码会误判是不是同一字段。
  4. 夹在两个同名键之间的注释不会改变模型,因为注释被丢弃。
  5. 多文档流里,三条短横线分开的是不同文档,并不是同一映射里的两次赋值,它们不会自动合成一次覆盖。

判断依据:只要同一映射节点出现相等键,结果就不是规范保证的可移植表示。此时不应再根据谁写在后面做结论。

失败时下一步

不要靠反复调换两行顺序做试验来推断覆盖规则,那只会把结论绑死在当前处理器上。删除重复,使每个映射只保留唯一键,再加载一次,以表示中的单一值为准。若删除后仍失败,按格式不良排查引号、缩进和文档标记。需要同一节点出现多处时改用别名。确认稳定前保留改前字符流。

资料来源: https://yaml.org/spec/1.2.2/