读大二进制日志时必须用io.ReadAt直接操作*os.File，因bufio.NewReader会破坏随机读能力导致offset错乱；须用int64防溢出、校验offset合法性、binary.Read解析header并注意大小端与字段导出。
读大二进制日志时，os.ReadFile 会直接 OOM；必须用 io.ReadAt 按 offset 随机读，而不是“先加载再解析”。
为什么不能用 bufio.NewReader 包裹 *os.File
*os.File 原生支持 io.ReaderAt，但一旦套上 bufio.NewReader，就退化成顺序流——ReadAt 失效，后续所有位移跳转都会错乱。
- 常见错误现象：
ReadAt返回0, nil或随机截断，实际 offset 没生效 - 正确做法：直接对
*os.File调用ReadAt(buf, offset)，中间不加任何包装 - Windows NTFS 下
ReadAt性能略低，Linux ext4/XFS 更稳；若需高频随机读，建议预估 offset 分布做局部缓存
binary.Read 解析 header 时必须注意字节序和字段导出
手动拆 buf[0]、buf[4] 容易越界、大小端错乱、字段对齐失败；binary.Read 是唯一安全路径。
- struct 字段名必须首字母大写（导出），否则
binary.Read忽略该字段 - 字节序必须和生成方一致：
binary.LittleEndian对应 Pythonstruct.pack('iih')，错一个字节全盘崩溃 - 务必检查 error：常见
io.ErrUnexpectedEOF表示buf长度不够，或offset超出文件末尾
按 record 边界递进 offset 时，int64 转换不可省略
header 中的 Len 通常是 uint32，但 ReadAt 的 offset 参数是 int64；直接 int(hdr.Len) 可能溢出为负数，触发 panic “invalid argument”。
立即学习“go语言免费学习笔记（深入）”；
- 错误写法：
nextOffset = currOffset + int(hdr.Len) - 正确写法：
nextOffset := currOffset + int64(hdr.Len) - 每次调用
ReadAt前必须检查：if nextOffset = fileSize，否则提前退出
如何安全获取当前文件偏移量
Go 没有 fgetpos，但可用 Seek(0, io.SeekCurrent) 精确拿到当前位置（从文件头起算的绝对 offset）。
- 典型用途：在解析中途记录断点，或验证某次
ReadAt后指针是否意外偏移 - 注意：
*os.File必须可寻址（普通磁盘文件 OK，管道/标准输入不行），否则返回io.ErrSeeker - 示例：
pos, _ := file.Seek(0, io.SeekCurrent)，pos就是当前绝对偏移
最易被忽略的是 offset 合法性检查和 int64 强制转换——它们不出现在 happy path 里，只在文件末尾、header 损坏或 Len 字段异常时爆发，且错误信息极不直观。
