YAML 配置报错：常见语法错误对照表

手写配置或 Mixin 时，YAML 语法错误会导致配置加载失败。对照下表快速定位：

错误一：缩进不一致（最高发）

# 错：proxies 下两个元素缩进不同
proxies:
  - name: 节点A
     type: ss        # 多了一个空格
# 对：同级元素严格对齐，只用空格，禁用 Tab

报错特征：did not find expected key 或 mapping values are not allowed。编辑器开启「显示空白字符」能救命。

错误二：冒号后少空格

port:7890     # 错，冒号后必须有空格
port: 7890    # 对

错误三：特殊字符未加引号

password: p@ss:word!   # 含冒号等字符，解析歧义
password: "p@ss:word!" # 对：加引号

密码、含 emoji 的节点名、以 * 开头的值（如 fake-ip-filter 的 "*.lan"）都建议加引号。

验证工具

改完不确定对不对：在 Profiles 页面重新点选配置，看 Logs 有无解析错误；或把片段粘到任一在线 YAML 校验器先过一遍语法。报错信息里的行号指的是合并后配置的行号，用 Mixin 时以字段名定位比行号更可靠。