YAML 解析错误、缩进错误或字段不支持怎么处理?

Clash 配置是 YAML 文本,缩进、冒号、引号和列表符号错误都会导致配置无法加载。先按日志给出的行列定位语法,再确认字段属于当前内核版本。

  • 订阅与配置导入
  • 故障排查
简要回答

Clash 配置是 YAML 文本,缩进、冒号、引号和列表符号错误都会导致配置无法加载。先按日志给出的行列定位语法,再确认字段属于当前内核版本。 每次只改报错附近的一处,保存后重新加载;解析通过后再核对字段是否属于当前内核。

从 line 和 column 找到出错字段

根据日志里的 line 和 column 截取上下各三行,检查同级字段缩进、冒号后的空格、Tab 和未加引号的 #。

  • 错误日志是否给出 line 或 column
  • 字段值是否包含未转义冒号、井号或特殊字符
  • 缩进是否混用 Tab 和空格
  • 字段是否属于当前 Clash 或 Mihomo 版本支持范围

修正缩进、引号和内核不支持的字段

  1. 先按日志行号定位最小错误片段
  2. 用空格缩进,不使用 Tab
  3. 包含特殊字符的密码、SNI、path 建议加引号
  4. 确认使用的协议字段与当前内核文档一致(参见 配置参考出站代理配置

YAML 解析通过不代表节点一定能连接

Mihomo 扩展字段在原版 Clash 中可能无法识别

修改前保存原配置,便于回滚