先保存原配置并读错误行号
复制一份当前配置作为备份,再运行客户端的配置检查。命令行可以使用 mihomo -t -f config.yaml。先看报错行号、字段名和错误类型;如果配置来自订阅,先确认原文件是否能重新下载。
检查缩进与列表格式
YAML 用空格表示层级,不能用 Tab 代替缩进。同一层级的列表项要对齐,键和值之间需要冒号及空格。引号、括号或列表分隔符不成对,也可能让错误显示在后面的行。
检查字段类型和重复键
端口通常需要整数,开关需要布尔值,列表字段需要列表结构。相同层级重复写入同一个键时,检查器可能报错,也可能由解析结果覆盖前值。合并配置前先删掉重复字段,并确认引用的策略组名称实际存在。
每次只改一处再验证
根据首条错误修改一处,重新运行配置检查,然后再处理下一条。不要一次替换整段配置,也不要把包含令牌的订阅内容贴到公开论坛。字段要求可能随内核版本变化,疑难字段对照当前 Mihomo 配置文档。