故障排查

Clash 配置提示 YAML 错误？先查缩进、冒号和字段层级

YAML 解析错误常由 Tab 缩进、同级错位、冒号后的空格或复制残缺引起。本文用最小回退法定位，不建议整份配置重写。

发布于 2026/8/8 · 更新于 2026/8/8 · 4 项可核验来源

先看重点先保留原文件副本，撤销最后一次编辑并重新验证；YAML 缩进只能用空格，同级字段必须对齐。语法通过后若仍启动失败，再检查 Mihomo 字段和值，而不是把两类错误混在一起。

Clash 报 YAML parse error、mapping values are not allowed 或指出某一行时，先把它当成文本结构错误。YAML 尚未成功解析，节点是否可用、规则是否正确都还没进入判断阶段；如果订阅卡片显示的是 HTTP 状态码或连接超时，应改走订阅更新报错排查。

最省时间的办法是撤销最后一次手动修改。 如果原订阅能用，改完一段规则后失败，问题大概率就在新增片段或它与上下文的交界处，不需要重装客户端。

先备份，再看错误行的前后几行

复制当前文件到本地安全位置，但不要把含订阅 URL、节点密码或 UUID 的完整配置上传到在线 YAML 检测站。错误行经常只是解析器“终于无法继续”的位置，真正的缺口可能在它前一两行。

优先检查：

上一行引号、方括号或花括号是否闭合；
key: value 的冒号后是否有必要的空格；
列表项 - 是否与同级列表对齐；
中文冒号、弯引号是否混入；
复制时是否丢了开头或结尾。

YAML 缩进只能用空格

YAML 官方规范明确要求块结构的缩进使用空格，不能用 Tab；同级节点必须使用相同缩进层级。视觉上看起来对齐，不代表字节上相同。

错误示例：

dns:
	enable: true
  ipv6: false

改成一致的空格：

dns:
  enable: true
  ipv6: false

不必迷信“两空格”或“四空格”中的某一个数字，关键是父子层级和同级对齐一致。本站示例统一用两空格，减少肉眼判断成本。

解析通过，不代表 Mihomo 配置有效

YAML 只负责把文本读成映射、列表和标量。下面这种内容可能是合法 YAML，但字段放错层级、引用了不存在的代理组，Mihomo 仍会拒绝加载。

因此分两步：

先处理 YAML 解析器给出的缩进、引号、列表错误；
再按 Mihomo 当前官方文档核对字段名、类型、平台支持和引用关系。

不要为了消除一条错误，把整个配置交给 AI 或格式化工具重写。YAML 中列表顺序、字符串类型和复杂脚本可能有实际含义，大范围重排会制造新的差异。

用二分删除找到有问题的片段

新增几十行后无法一眼看出错误，可以保留副本，然后删掉新增内容的一半进行客户端校验。若仍失败，问题在保留的一半；若恢复，问题在删除的一半。重复几次即可缩到很小的片段。

这个方法只用于你刚添加的自定义内容，不要在远程订阅原文里随意删节点或凭据。更稳妥的做法是把自定义规则放在 Clash Verge Rev 的扩展配置或可视化规则编辑器中。

常见错误与含义

错误现象	先查什么
指向某行冒号	引号、冒号后空格、上一行是否闭合
`bad indentation`	Tab、同级错位、列表层级
`duplicate key`	同一映射内重复字段
`cannot unmarshal`	值类型不符，例如应为列表却写成字符串
配置校验通过但内核启动失败	字段支持、代理组引用、端口或平台限制

最终保留一次客户端内置校验结果，并重新启动内核验证。能保存文件不算成功，配置实际加载、代理组出现且日志没有回滚到旧配置，才算修复完成。

冒号、井号和看似普通的字符串

YAML 用冒号表示键值、井号开始注释。节点名称、URL 或规则里含这些字符时，是否需要引号取决于位置和上下文。最稳妥的做法不是给整份文件所有值乱加引号，而是按 Mihomo 官方示例处理出问题的字段。

on、off、数字和日期在不同 YAML 版本或解析器中还可能被解释成不同类型。Mihomo 需要布尔值时写 true/false，需要字符串时明确引用，避免“语法合法但类型不对”。

重复键不会总以你预期的方式失败

在同一个 dns: 映射里重复写两次 enable:，有的工具报 duplicate key，有的解析器可能保留最后一个。无论哪种，都让实际生效值难以审查。

添加扩展前先搜索同层字段。需要覆写时使用 Clash Verge Rev 的扩展配置层，不要在远程文件相隔几百行再写一份同名结构。

规则行本身也有第二层语法

YAML 成功读出一条字符串后，Mihomo 还要解析 DOMAIN-SUFFIX,... 等规则内容。逗号数量、策略组名称或逻辑括号写错，可能表现为内核校验失败而非 YAML 错误。

因此错误信息里若已经指向 rule、proxy-group 或 provider，就转去核对 Mihomo 对应章节。继续调整空格和缩进不会修复不存在的策略组。

只分享最小脱敏片段

求助时给出错误行前后约十行，并用占位符替换服务器、token、UUID 和密码，同时保留缩进。不要截图时裁掉行号和错误全文，也不要把整份订阅放进公开 paste 服务。

最小片段能独立复现时，别人更容易判断是 YAML 结构还是 Mihomo 字段；不能复现时，再逐步增加相邻结构，而不是一开始公开所有凭据。

资料来源

以下来源于 2026/8/8 复核。版本、支持平台和发布状态以后续官方页面为准。

持续更新

收到新教程，也欢迎纠错

想收到新文章，可以关注 TG 频道；发现下载失效、套餐变化或步骤不一致，请附上页面链接和可公开的截图。不要发送订阅链接、密码或完整账户信息。

关注 TG 频道 Telegram 纠错邮件纠错

读者互动

这篇内容对你有帮助吗？

— 次访问— 累计日独立访问— 条评论

直接说出你的问题