CClash 中文下载站选择客户端 ↗
首页/博客
故障排查

Clash 配置报缩进错误时怎样定位附近几行

Clash 配置报缩进错误时怎样定位附近几行。了解适用条件、操作步骤与常见问题的排查方法。

编辑部 · 更新 2026-10-04

Clash 配置若被报成缩进错误,说明处理器在解析字符流、生成序列化树时已判定输入不成形。YAML 1.2.2 写明解析可因 ill-formed input 失败。定位附近几行,是找出哪一处行首空格没能正确打开或关闭块集合作用域,而不是去改尚未进入构造阶段的应用字段。

适用条件

适用于块状序列与块状映射:它们用缩进确定作用域,条目各占一行。流式样式用方括号、花括号表示范围,缩进不负责作用域;若出错行主要是流式写法,应先查括号与逗号。多文档流用 --- 开始文档、用 ... 结束文档且不开始新文档,缩进不得跨文档借用上一文档的列。

“附近”建议固定为四类行:报错行、上一非空行、同一父节点下的前一兄弟、比该行更少缩进的最近祖先。空行有独立产生式,不能当作结构对齐的尺子。注释行同样不进入表示图。

用结构规则核对这几行

先比较报错行与声称父节点的列。子内容必须落在父条目的缩进之内;某键的值若少缩进,会被读成与父键同级,映射关系在附近几行就会错位。再比较兄弟:同一序列里以短横线加空格开头的条目、同一映射里的键,应在同一缩进列。某一行多或少若干空格,作用域会在该行提前结束或并入上一节点。

接着分开两类空白。缩进空格只出现在换行后的行首;分隔空格出现在短横线或冒号之后,用来构成块条目,并不表示新的一层。缺分隔空格、或把分隔空格当成新层,附近行的列参照会全部失效。紧凑嵌套允许键值紧跟短横线、冒号或问号,因此窗口必须包含该指示符所在行:子映射可能从同一行开始,下一行的缩进相对该条目。

若错误落在 | 或 > 之后,应读块标量标题上的缩进指示。字面样式保留换行;折叠样式在普通换行处折成空格,但空行与更缩进的行会保留换行。不可用外面映射的缩进去套标量正文。定位时只比较节点行的缩进空格,忽略注释里的 # 对齐,也忽略行内键值之间的分隔空格。

仍对不齐时的下一步

把窗口内的行剪成一份独立最小流,保留同样的相对缩进和文档起始标记,去掉注释与无关键。若最小流已经成形,问题在剪掉的祖先或未闭合的块标量。若最小流仍失败,只调整这一处相对缩进,或把该片段改成流式集合再解析,以确认失败是否真由缩进引起。确认 well-formed 之后,才处理别名是否已标识、标签是否可解析、标签是否被识别为合法等后续加载失败点,避免把缩进行写成类型错误。

https://yaml.org/spec/1.2.2/