YAML 语法错误:无效缩进
快速摘要
你的 YAML 文件有语法错误 —— 不一致或不正确的缩进阻止了解析。
为什么发生
使用制表符而非空格缩进(YAML 要求空格)
缩进不一致 —— 同级项目有不同缩进
映射键缺少值或列表项缺少破折号前缀
最小示例
✗ 错误代码
services:
web:
ports:
- '80:80'
db: # tab character — YAML error
ports:
- '5432:5432'✓ 修复代码
services:
web:
ports:
- '80:80'
db: # spaces — valid YAML
ports:
- '5432:5432'将制表符替换为空格使 YAML 有效并允许正确解析。
如何诊断
使用 YAML linter 或验证器识别错误的确切行和列
检查制表符并用空格替换
验证同嵌套级别的项目有一致缩进
如何修复
将制表符替换为空格并确保整个文件缩进一致
修复错位项目的缩进以匹配其嵌套级别
按 YAML 语法要求添加缺失的值或列表项破折号
如何预防
在编辑器和 CI 流水线中使用 YAML linter 以尽早捕获语法错误
配置编辑器对 YAML 文件使用空格并强制一致缩进