Skip to content

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 文件使用空格并强制一致缩进

相关资源

相关术语

相关课程

← 返回语言