yaml缩进和横杠语法是java项目中解析application.yml的硬性规则：缩进用空格标识层级，同级必须对齐且禁用tab；横杠“-”后必须跟空格才能定义列表项，否则引发类型异常或解析失败。
Java 项目中读取 YAML 配置文件（比如 application.yml）时，YAML 的缩进和横杠语法不是“风格偏好”，而是解析器识别结构的硬性依据。理解这两点，等于掌握了 YAML 在 Spring Boot 等框架里不报错、不误读的关键。
空格缩进：层级关系的唯一标识
YAML 不用大括号或方括号，全靠缩进来表达嵌套。Java 的 YAML 解析器（如 SnakeYAML 或 Spring Boot 内置的）会严格按空格数判断父子关系：
- 同一层级的所有 key 必须左对齐——哪怕只差一个空格，就会被当成不同层级或解析失败
- 禁止使用 Tab 键：IDE 可能自动转成空格，但若原始文件含 Tab，Spring 启动时大概率抛
ScannerException或静默忽略字段 - 缩进量无固定要求（2格、4格都行），但必须“同级一致”。例如：
server:
port: 8080
address: localhost
spring:
profiles:
active: dev
这里port和address同属server，所以缩进相同；active缩进更深，表示它是profiles的子项
横杠（-）+ 空格：列表项的强制写法
YAML 中没有 []，列表靠 - （短横线加一个空格）定义。Java 解析时，它直接映射为 List 或数组：
- 每个
-必须顶格或与所属 key 对齐，且后面必须跟一个空格，否则会被当作文本字符串处理 - 支持嵌套列表和混合结构。例如：
redis:
hosts:
- 192.168.1.10:6379
- 192.168.1.11:6379
timeout: 5000
解析后，hosts是List<string></string>，timeout是Integer - 若漏掉空格（如
-192.168.1.10:6379），YAML 会把它当成数字负值，导致类型转换异常
常见坑点与验证建议
在 Java 项目中，光写对不够，还要确保被正确加载：
- 用 IDE 的 YAML 插件（如 IntelliJ 的 YAML Support）实时高亮缩进错误和无效横杠
- 启动时加
--debug参数，观察 Spring 是否成功绑定配置到@ConfigurationProperties类 - 写完后用在线校验器（如 yamlchecker.com）粘贴内容快速验证语法
- 避免中文冒号、全角空格等隐形字符——它们会导致解析中断，且错误提示往往不明确
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
