PushbackInputStream是Java IO中支持预读与回退的装饰器流，通过内部缓冲区实现unread操作，适用于词法分析等需前瞻判断的场景；默认缓冲区大小为1，可指定更大容量，但超限或嵌套回退会抛IOException。
PushbackInputStream 是 Java IO 中专为“预读+回退”场景设计的装饰器流，它在底层输入流前加了一小块缓冲区，允许你把刚读取的字节“推回去”，下次读取时会优先返回这些被推回的字节。这在实现带前瞻判断的解析器（比如词法分析、协议解析）时非常实用。
核心原理：缓冲区 + peek + unread
它内部维护一个固定大小的字节数组（默认1），用作“回退槽”。调用 read() 时，先检查缓冲区是否有字节，有则返回并清空；没有才从底层流读。调用 unread(int b) 或 unread(byte[] b) 时，并不是真正写入底层流，而是把字节存进缓冲区（若缓冲区已满会抛 IOException）。关键点是：回退操作必须在 read() 之后、且未被其他 read 消耗前进行。
典型使用模式：先 peek 再决定逻辑分支
常见于需要根据下一个字节判断后续处理方式的场景，例如解析以特定字符开头的结构：
- 读一个字节，判断是不是 '{' —— 是则按 JSON 对象解析；
- 如果不是，但可能是数字或字母，需把该字节“还回去”，再交给通用 token 解析器处理；
- 此时 unread(b) 就让这个字节重新“可见”，后续 read() 会拿到它。
注意缓冲区容量和异常边界
默认缓冲区只支持回退 1 字节。如果需要多字节回退（如 peek 多个字符），必须显式指定更大容量构造：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
new PushbackInputStream(in, 4); // 支持最多回退 4 字节但要注意：
- unread 超过缓冲区容量会抛 IOException；
- 不能 unread 已经被 unread 过的字节（即不支持嵌套回退）；
- 底层流本身不可回退，PushbackInputStream 的回退能力完全依赖其内部缓冲区。
实际解析示例：简单配置行识别
假设解析文本配置，每行以 '#' 开头为注释，以 'key=value' 形式为配置项：
- 用 PushbackInputStream 读第一个字节；
- 如果是 '#'，跳过整行；
- 否则 unread 它，再用 BufferedReader.readLine() 完整读取该行并解析 key/value；
- 这样避免了因读走第一个字节导致行内容错位。
