Go os.File.Truncate 怎样调整文件长度并处理偏移

用 os.File.Truncate(size) 调整文件时，最容易弄错的是把“文件长度”和“下一次读写位置”当成同一个值。结论先说：Truncate 会把文件长度改成 size，但不会移动当前 I/O offset。要在截断或扩展后从指定位置写入，必须显式调用 Seek；成功与否还要用 Stat 或 ReadAt 复查。

Go os.File.Truncate 先分清长度和偏移

File 内部至少要分开看两个状态：文件的长度由 EOF 表示，读写 offset 则表示下一次 Read 或 Write 的位置。把 1 KB 文件截成 200 字节，不等于把 offset 自动放到 200；如果 offset 原来是 80，它仍然是 80。

这也是为什么“截断后追加内容”不能只调用一次 Truncate。你要先决定写入点：写到新 EOF 就 Seek(0, io.SeekEnd)；覆盖某段区域就按业务偏移 Seek 到目标位置。

用一个原创示例演示缩短和扩展

下面的示例故意先写入一段内容，再把 offset 移到 3，随后把文件缩短到 5 字节。缩短本身不会改变 offset，所以代码在复查时单独打印当前位置。

package main

import (
    "fmt"
    "io"
    "os"
)

func main() {
    // 以读写方式打开临时文件，结束时关闭描述符。
    f, err := os.CreateTemp("", "truncate-demo-*")
    if err != nil { panic(err) }
    defer func() {
        // 关闭文件并清理临时路径，避免示例残留。
        _ = f.Close()
        _ = os.Remove(f.Name())
    }()

    if _, err = f.WriteString("0123456789"); err != nil { panic(err) }
    // 把下一次 I/O 位置放到第 3 个字节，观察 Truncate 不会改它。
    if _, err = f.Seek(3, io.SeekStart); err != nil { panic(err) }
    if err = f.Truncate(5); err != nil { panic(err) }

    pos, err := f.Seek(0, io.SeekCurrent)
    if err != nil { panic(err) }
    info, err := f.Stat()
    if err != nil { panic(err) }
    fmt.Printf("offset=%d size=%d\\n", pos, info.Size())
}

这里预期的关系是 offset=3、size=5。示例的重点不是某一行输出，而是两个状态仍然独立：要改变长度用 Truncate，要改变下一次读写位置用 Seek。

缩短、扩展后怎样安排 Seek 和复查

还有三个边界值得单独记住：size 会返回错误；只读打开的文件不能完成修改；路径不存在、权限不足等错误应保留 *os.PathError，不要只打印一句“truncate failed”就丢失操作名和路径信息。若是符号链接，路径级的 os.Truncate 与打开文件后的 File.Truncate 还要按对象语义分别确认。

常见问题

Truncate 后为什么写入位置没有到文件末尾？

因为它只改长度，不改 offset。需要追加时显式调用 Seek(0, io.SeekEnd)，再执行写入。

扩展文件后新增区域一定能读到有效业务数据吗？

不能把扩展长度当成业务初始化。长度改变后应在明确偏移写入内容，并用 Stat、ReadAt 或校验和复查。

什么时候用 os.Truncate 而不是 File.Truncate？

已有打开文件、需要复用 offset 或继续写入时用 File.Truncate；只按路径修改长度时才考虑 os.Truncate，并分别处理它们返回的 *os.PathError。