订阅更新提示格式错误？YAML 常见坑位清单

订阅能下载但导入失败，最常见的就是 YAML 格式不规范。别急，按下面清单逐项排查，通常 3 分钟就能定位问题。

一、最容易踩的 5 个坑

1. 缩进混乱：YAML 只能用空格，不能用 Tab。任何一行缩进不一致都会报错。
2. 冒号后没空格：例如 port:7890 必须是 port: 7890。
3. 中文标点：复制时把英文冒号、逗号变成中文符号，解析会失败。
4. 引号未闭合：名字里有引号或冒号时，需要成对英文引号。
5. 重复键名：同一层级出现两个 proxies 或 rules，会导致覆盖或报错。

二、快速自检方法

• 用在线 YAML 校验：贴进去立刻报错定位行号。
• 用文本编辑器显示空白：查看缩进是否一致。
• 对比官方示例：把关键字段按模板替换，最不容易出错。

三、最稳的修复方式

• 先 新建空白配置，手动复制关键字段。
• 只保留 port / socks-port / proxies / proxy-groups / rules 五个核心块。
• 每次修改后保存并重新导入，避免多处问题叠加。

小结

格式错误不是节点问题，而是配置问题。按“缩进—冒号—标点—引号—键名”顺序排查，几乎都能解决。