YAML 解析错误、缩进错误与字段不识别怎样分开检查

看到行号、列号或字段无法识别的提示时,先保留原配置,再查看报错附近的文本。语法修正与内核字段支持是不同的检查环节,应结合提示分别判断。

  • 远程配置的载入
  • 异常处理
处理要点

修改前留存原文件,按报错给出的行列检查相邻内容;每次处理局部问题后重新载入,再观察提示是否变化。YAML 对列表、缩进和标点的写法有要求,即使语法已能解析,也仍需核对字段是否被当前内核支持。

备份 原文件, 依据 行列位置 检查局部语法写法

先定位 line 与 column 标出的附近内容,对齐同层字段,再查看 Tab、冒号后的间隔以及井号的引号处理。

  • 查看缩进是否使用了 Tab,或与空格交错混排。
  • 检查字符串里的冒号、井号及其他特殊字符,确认转义或引号写法恰当。
  • 从错误记录中提取列号与行号,定位需要检查的局部文本。
  • 对照当前内核的说明,确认相应版本能否识别这些字段。

调整文本层级与标点,重新载入后核对内核字段支持

  1. 保留修改前的文件,再缩小到报错行附近检查。
  2. 统一以空格表达层级,替换混入缩进的 Tab。
  3. 遇到包含特殊符号的 path、SNI 或密码值时,用恰当的引号包围内容。
  4. 核对协议说明与所用内核,辨认字段支持范围后再调整配置。(延伸阅读: 配置字段说明、出站字段说明)

语法通过就能保证连接吗?代理仍可能连接失败,需继续检查实际连接状态。

扩展字段能直接用于其他实现吗?不同内核的识别范围可能不同,应按当前版本核对。

改错后如何恢复?保留原文件,出现新的问题时可回到修改前的配置。