先保留原稿,再读错误位置

修改前复制一份已知能加载的配置,保留原文件名、所在目录与修改记录。确认编辑器打开的路径和运行程序读取的路径一致;如果程序仍在读取另一份文件,再正确的修改也不会改变行为。配置入门介绍了文件位置与基础字段的关系。

记录解析器给出的行号与列号,再查看前后几行。上一行少了引号、冒号后没有空格,或列表突然回到了错误的层级,都可能让错误在后续行才显现。不要仅凭提示中的一个单词判断整个字段不受支持。

用空格表达父子关系

YAML块结构的缩进使用空格,不能把Tab当作普通缩进。编辑器可开启显示空白字符,并统一同级缩进宽度;常用两个空格是编辑约定,不是Mihomo独有的语法。一次转换整篇文件后,还应检查列表下的多行对象是否仍然对齐。

YAML · 演示片段,不用于真实连接
proxy-groups:
  - name: "手动选择"
    type: select
    proxies:
      - DIRECT
rules:
  - MATCH,手动选择

这里proxy-groups对应列表,短横线开始一个组对象。name、type、proxies是同一个对象的键,DIRECT属于proxies内部的列表。最外层rules与proxy-groups对齐。这个演示只有直连候选,不含可用代理节点,也不是完整连接方案。

冒号、引号与注释各有边界

普通键值写成“键: 值”,冒号后保留分隔空格。值中若包含“冒号加空格”或可能被理解成注释的井号,应使用合适的引号包住。引号内的井号是字符串内容,引号外由空白分隔的井号可开始注释。不要从文档中复制中文弯引号代替YAML引号。

同一个映射中不要重复定义同名键。解析器对重复键的处理可能不同,不能依赖“后写的一定覆盖前写的”。文件使用UTF-8保存,注意扩展名没有变成.yaml.txt;复制网页代码后检查全角空格、不可见字符和多余的代码围栏。

逐段缩小范围,而不是逐字试错

先在副本中移除刚加入的独立段落,观察错误能否消失,再按完整层级逐段放回。删除一行列表项时要连同它的子字段一起处理,避免制造第二个问题。来源文件如果也使用YAML,可以结合节点提供者的文件结构分别检查,别把主配置与提供者内容拼成同一层。

通用YAML解析通过,只说明文档结构可读取;字段类型、组名引用、提供者文件仍需单独验证。下一步按配置验证与加载排查检查语义和活动配置。每次只改变一个可解释的因素,保留能复现的错误,比清空重写更容易找到原因。

把错误定位到一个明确层级后,再恢复其余配置。保留这次修改的差异,下一次遇到相似报错,就有一份可对照的原稿。