ByteBuffer.putInt 不能直接指定位置写入是因为其无绝对位置重载，仅在当前 position 写入并自增；需用 putInt(index, value) 绝对写入或临时调整 position。
ByteBuffer.putInt 为什么不能直接指定位置写入？
因为 putInt() 本身没有「绝对位置写入」的重载版本——它只在当前 position 处写入 4 字节，然后自动将 position 增加 4。如果你需要往某个固定索引（比如下标 12）写入，直接调用 putInt(123) 会覆盖当前位置，而不是你心里想的那个「第 12 个字节开始」。
如何安全地往指定字节偏移处写入 int？
有两种主流方式，取决于你是否愿意临时修改缓冲区状态：
- 用
putInt(int index, int value)：这是最直接的绝对写入方法，index是字节索引（不是元素序号），必须满足0 ≤ index ≤ limit - 4，且不改变position、limit或mark - 临时移动
position：先调用position(index)，再调用putInt(value)，最后可选地恢复原position（适合链式写入场景）
示例：
ByteBuffer buf = ByteBuffer.allocate(32); buf.putInt(12, 0x12345678); // ✅ 绝对写入：从字节偏移 12 开始存 int // 此时 buf.position() 仍是 0，没变
常见错误：越界、大小端、只读缓冲区
这三个问题最容易导致运行时报错或数据错乱：
-
IndexOutOfBoundsException：当index超出[0, limit-4]范围，例如buf.putInt(30, 1)在limit=32时合法，但在limit=31时非法（31−4=27，30 > 27） - 字节序影响结果：默认是大端（
ByteOrder.BIG_ENDIAN），若需小端，得提前设置buf.order(ByteOrder.LITTLE_ENDIAN)，否则putInt(0x01020304)写出来的字节序列是01 02 03 04还是04 03 02 01完全取决于这个设置 -
ReadOnlyBufferException：对只读缓冲区（如ByteBuffer.wrap(array).asReadOnlyBuffer()）调用任何put*方法都会抛此异常，检查buf.isReadOnly()可提前规避
性能与使用建议
绝对写入（putInt(int, int)）比移动 position 再写入略快，因为它跳过了状态检查和更新；但要注意它不参与缓冲区的「流式写入」逻辑——也就是说，它不会推动 position，也不会触发 flip()/compact() 的预期行为。所以：
- 批量结构化写入（如协议头、帧字段）推荐用绝对写入，清晰可控
- 顺序追加数据（如日志拼接、流式编码）就老实用
putInt(value)配合position()管理 - 永远在写入前确认
buf.remaining() >= 4或显式校验index边界，别依赖 try-catch 拦截IndexOutOfBoundsException
最易被忽略的是：putInt(int, int) 中的 int 参数是字节索引，不是「第几个 int」——一个 int 占 4 字节，往偏移 8 写入，对应的是缓冲区的第 9～12 字节，不是第 3 个 int。
