Clash 报错「proxies 必须是数组」是什么意思，怎么改

一句话结论：这个报错的意思是 proxies: 下面写成了「一个值」，而 Clash 期待的是「一串值」。 在 YAML 里，一串值的写法是每项前面加一个短横线加空格（- ）。缺了短横线、缩进层级不对、或者把节点分享链接直接粘进去，都会触发它。

这个报错到底在说什么

Clash 的配置里，proxies 是节点列表。列表在 YAML 里叫序列（sequence），必须写成这样：

proxies:
  - name: 香港01
    type: ss
    server: hk1.example.com
    port: 443
  - name: 日本01
    type: trojan
    server: jp1.example.com
    port: 443

注意两件事：每个节点的第一行以 - 开头，同一个节点的其余字段与 name 左对齐。解析器看到 - 才知道「这里开始了列表的一项」。

如果写成下面这样，proxies 的值就变成了一个普通字符串，而不是列表：

proxies: 香港01

或者变成一个映射（键值对），同样不是列表：

proxies:
  name: 香港01
  type: ss

两种情况客户端都会报「proxies 必须是数组 / 应为序列 / 无法解析」之类的错误，具体措辞各客户端不同，但说的是同一件事。

四种常见成因

一、复制配置时漏掉了短横线

这是最常见的。从网页或聊天记录复制片段时，行首的 - 容易被吞掉，尤其是复制的内容经过了某些编辑器的自动格式化。检查每个节点的第一行是不是都以 - 开头——只有第一行需要，后续字段不要加。

二、把节点分享链接直接粘进了 proxies 下面

proxies:
  - vmess://eyJ2IjoiMiIsInBz...

这样写不行。vmess:// 这类分享链接不是 Clash 配置格式，Clash 不认识它们。分享链接是给客户端「导入」用的，而配置文件里需要的是展开后的字段（name、type、server、port 等）。

如果你手上只有分享链接，可以先用节点链接解析器把它解开看清里面有什么，再手写成配置格式；或者直接把链接导入客户端，让客户端自己转换。

三、缩进层级错了

proxies:
- name: 香港01
  type: ss

这样其实是合法的 YAML——短横线可以和 proxies 左对齐。但如果你混用了两种风格，或者某个节点多缩进了两格，解析结果就会跑偏：

proxies:
  - name: 香港01
    type: ss
    - name: 日本01      # 错：这个短横线缩进太深，成了上一个节点的子项
      type: trojan

建议全文统一用「短横线缩进两格」的风格，不要在同一份配置里换来换去。

四、proxies 键重复出现了两次

proxies:
  - name: 香港01
    type: ss

# ……中间隔了很多行……

proxies: []

YAML 里同层的键重复时，后面的会覆盖前面的。如果第二个 proxies 是个空列表或者写错了类型，前面辛苦写的节点就全没了。这种情况通常发生在把两份配置拼在一起的时候。

怎么快速定位

肉眼逐行找缩进很累，而且 Tab 和空格看起来一模一样。把配置粘进配置校验器，它会直接告诉你是第几行出的问题、这一行为什么不合法。它查的不只是 YAML 语法，还包括 Clash 特有的结构问题——比如节点缺少必需字段、策略组引用了不存在的节点名。

工具在你的浏览器里运行，配置不会上传。

连带会遇到的问题

proxies 修好之后，常常紧接着冒出第二个错误：策略组引用了不存在的节点。原因是你刚才改动节点时顺手改了 name，而 proxy-groups 里还写着旧名字。Clash 对节点名的匹配是严格的——大小写、空格、emoji 都算数，「香港01」和「香港 01」是两个不同的名字。

另一个高频连带问题是 rules 最后没有 MATCH 兜底。没有它，未命中任何规则的流量走什么策略取决于客户端默认值，不同客户端不一致，表现就是「大部分网站正常，个别网站莫名其妙不走代理」。

小结

• proxies 报错基本等于「少了短横线」或「缩进不对」
• 分享链接不能直接写进配置，那是两种不同的格式
• 同层重复的键会静默覆盖，拼接配置时尤其要小心
• 与其肉眼找，不如把配置粘进校验器让它指行号