缩进表达的是结构
mihomo 使用 YAML 配置,官方语法说明强调区分大小写并用空格缩进。某个字段缩进到另一层后,含义可能改变或不再被识别,因此编辑器中的对齐不是纯粹排版。修改前先看周围同层字段的结构,不要从聊天工具复制后只凭视觉认为内容仍然一样。
文字数字列表不能随意互换
配置值可能是字符串、数字、布尔值、列表或对象,字段期望哪种类型应查看官方说明。逗号分隔的一行文字不一定等同于列表,注释也不会自动成为配置项。复制示例时只保留自己理解且需要的字段,不把示例里的地址、名称和密码原样当成自己的有效配置。
从一处修改开始检查
先保存一份私密副本,只改一个字段或一组紧密相关内容,再使用客户端提供的检查或加载功能观察错误。解析器指出的行号附近需要一起查看,因为结构错误可能从上一行开始。不要将含完整凭据的文件上传到未知在线校验网站;必要时制作不具访问能力的最小样本。
能解析不等于行为正确
格式检查只能帮助发现结构与部分配置问题,无法证明节点账户有效、规则符合需求或目标应用可用。加载后还要检查实际生效配置和一个对应任务。若某字段被界面或扩展覆盖,继续修改原始文件可能没有作用,应查清客户端的配置生成过程再确定维护位置。
保留差异比保留整段聊天有用
给每次修改写一句原因,并保存改动前后相关字段的差异,不要把全部历史版本随意散落在下载目录。确认稳定后清理无用副本,敏感备份继续妥善保管。遇到无法解释的解析错误,恢复上一个可用版本,再逐项重做比一次重写整个配置更容易找出问题。
例如在编辑器里把某个选项移到另一段下方,文字完全相同但缩进多了一级,解析后的层级就可能改变。先对照官方示例的结构与同级字段,而不是反复改选项数值。使用能够显示空格和行号的编辑器有助于查看差异,但不要让工具自动上传配置求诊断。修复后先验证格式,再检查实际功能;若只验证错误提示消失,仍可能留下一个语法正确却放错位置的字段。
资料来源
以下来源用于核对概念和操作条件。产品界面与政策可能变化,请结合当前官方说明使用。