YAML 错误常发生在导入或更新配置后。它既可能是真正的缩进或语法问题，也可能是下载到网页错误页、登录页或不完整文件。先确认“拿到的到底是什么内容”，再决定是否检查格式，效率会高得多。
先确认文件不是网页或空内容
用文本编辑器打开文件，查看开头是否像配置内容，还是 HTML、提示页面或异常文本。订阅 URL 返回的内容如果不是有效配置，客户端也可能只显示 YAML 报错。不要把订阅链接公开粘贴到在线工具中检查。
YAML 常见格式问题
YAML 对缩进和冒号非常敏感。复制时混入制表符、少了引号、层级错位都可能让解析失败。若是手动编辑造成的，先恢复到修改前的备份，再一次只改一处，并重新加载验证。
还要考虑客户端兼容性
某些字段只被特定核心或客户端支持。即使 YAML 语法正确，客户端仍可能因为不支持字段而无法加载。此时应查看完整错误文本和项目说明，而不是盲目删除区块。
配置的核心结构可参考代理组、规则和 DNS 说明；订阅下载异常则先看导入失败排查。
常见问题
把文件后缀改成 yaml 能修好吗？
不能。后缀不会把错误内容变成有效配置，必须先确认文件实际内容。
缩进用几个空格？
应与原配置保持一致，关键是层级一致且不要混用制表符。
错误行号可信吗？
它是重要线索，但解析器有时会在真正问题之后的位置报错，应同时查看附近内容。
