核心是利用loadall()的懒加载特性实现流式解析：yaml yaml = new yaml(new safeconstructor()); for (object doc : yaml.loadall(is)) { ... }，配合loadas()映射pojo，避免反序列化风险与内存占用。
在非 Spring 的纯 Java 项目中，用 SnakeYAML 流式解析 YAML（.yml）配置文件，核心是避免一次性加载全部内容、减少内存占用，并支持边读边处理——尤其适合大配置、多文档或动态结构场景。关键不在于“流式”字面意义（YAML 本身不是流式格式），而在于利用 loadAll() 的懒加载特性 + 迭代式消费，配合类型安全映射。
确认依赖版本并初始化 Yaml 实例
使用较新稳定版（如 1.30+），确保支持 Java 17+ 和嵌套泛型：
- Maven：
1.30 - Gradle：implementation 'org.yaml:snakeyaml:1.30'
- 创建
Yaml实例时，**不推荐默认构造器**；建议显式传入new SafeConstructor()或自定义Constructor，防止反序列化任意类带来的安全风险
按需加载单个或多个 YAML 文档
loadAll() 返回 Iterable<object></object>，遍历时才真正解析每个文档，这就是实际意义上的“流式”：
- 适用于一个 .yml 文件含多个
---分隔的文档（如多环境配置块） - 代码示例：
Yaml yaml = new Yaml(new SafeConstructor()); try (InputStream is = getClass().getClassLoader().getResourceAsStream("config.yml")) { for (Object doc : yaml.loadAll(is)) { if (doc instanceof Map) { Map<string object> map = (Map<string object>) doc; System.out.println("Top-level keys: " + map.keySet()); } } }</string></string>
直接映射到强类型 POJO（推荐方式）
比手动遍历 Map<string object></string> 更安全、可维护。SnakeYAML 支持通过 loadAs() 或带构造器的 Yaml 实例完成类型绑定：
- 定义清晰的 POJO 类（含 public 无参构造器、标准 getter/setter）
- 嵌套结构也支持：如
AppConfig包含DatabaseConfig database字段，YAML 中对应缩进结构即可 - 示例：
Yaml yaml = new Yaml(new Constructor(AppConfig.class)); AppConfig config = yaml.loadAs(is, AppConfig.class);
- 若配置含列表（如
endpoints: [{url: "/api"}, {url: "/health"}]），POJO 中用List<endpoint></endpoint>声明即可自动填充
处理常见结构与边界情况
真实配置常含空值、注释、锚点、类型歧义等，需注意：
- 空字段默认为
null，POJO 字段应允许 null 或加@Nullable注解 - YAML 中的日期（
2024-01-01）、布尔（on/off）、数字（0xFF）会被自动转为目标类型，无需额外处理 - 避免使用
!!标签强制类型（如!!java.util.ArrayList），这会引入反序列化漏洞风险 - 如需兼容 Spring Boot 风格的占位符（
${port:8080}），SnakeYAML **原生不支持**，需自行预处理字符串或集成轻量替换逻辑
不复杂但容易忽略：始终用 SafeConstructor、优先走 loadAs、用 loadAll 替代单次 load 处理多文档——这三点就构成了干净、可控、生产可用的 YAML 解析链。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
