LineNumberReader 的核心价值是自动维护行号，起始为0，遇换行符自增，支持精准错误定位、跳过注释/空行仍保持物理行号连续、setLineNumber() 对齐上下文、配合 try-with-resources 确保资源安全。
LineNumberReader 的核心价值，是在逐行解析文本时自动维护当前行号，无需手动计数。它不改变读取逻辑，只在每次 readLine() 遇到换行符（\n、\r\n 或 \r）后自增行号，起始值为 0。这意味着第一行实际对应行号 1（调用 readLine() 后才变为 1），非常适合定位配置错误、语法异常或日志结构偏差。
错误报告中精准嵌入行号
当解析器检测到非法格式（如缺失字段、非法字符、不符合 schema 的键值对）时，直接调用 getLineNumber() 获取当前行号，拼入异常消息即可。例如：
- 配置文件中某行缺少等号：
throw new IllegalArgumentException("第" + reader.getLineNumber() + "行格式错误：未找到'='分隔符"); - 日志行时间戳解析失败：
logger.error("解析失败（文件行 {}）：{}", reader.getLineNumber(), line); - 不依赖 try-catch 包裹每行处理——只需在业务校验失败点插入行号，避免侵入式计数逻辑
跳过注释与空行仍保持行号连续
行号递增由底层换行符触发，与内容无关。即使你主动 continue 跳过以 # 开头的注释行或 line.trim().isEmpty() 的空行，getLineNumber() 返回的仍是物理行号。这对审计和复现至关重要：
- 第 5 行是空行 → 行号计为 5
- 第 6 行是
# debug mode→ 行号计为 6 - 第 7 行才是有效配置 → 行号计为 7
- 错误提示“第 7 行”用户可直接打开编辑器跳转，无需人工数行
setLineNumber() 的合理用途
setLineNumber(int) 不用于跳转，而是用于对齐外部上下文。常见场景包括：
- 文件本身带 BOM 或头部注释块，你想让第一行有效数据显示为“第 1 行”，可在读取前调用
setLineNumber(0)（默认已是 0，通常无需操作） - 从某个已知偏移位置开始解析（如跳过前 10 行元数据），调用
setLineNumber(10)，后续报错即显示“第 12 行”而非“第 2 行” - 合并多个片段时统一行号基准，比如将子配置嵌入主配置，手动修正起始编号
搭配 try-with-resources 确保资源安全
大型日志文件可能持续数小时生成，必须防止句柄泄漏。使用自动资源管理是最简健壮写法：
- 声明时直接包裹：
try (LineNumberReader reader = new LineNumberReader(new FileReader("app.log"))) { ... } - 无需手动
close()或finally块，JVM 保证流关闭，即使循环中抛出异常 - 若需 UTF-8 支持，改用
Files.newBufferedReader(Paths.get("..."), StandardCharsets.UTF_8)构造再包装，避免平台默认编码风险
