Go os.File.Truncate 怎么扩展或缩短文件并判断结果

日志轮转、临时文件复用和导出文件修整时，经常需要把文件改成一个明确的字节长度。Go 的 (*os.File).Truncate 适合已经打开文件的场景：它改变文件大小，但不会改变文件当前的 I/O 偏移。也就是说，真正需要注意的不是“能不能截断”，而是目标长度、当前游标和错误处理是否分别判断。

官方地址：https://pkg.go.dev/os#File.Truncate

本文只讨论标准库的文件长度调整，不展开稀疏文件性能优化。代码示例是写法说明，图片是静态结构图，不是运行截图或执行证据。

Truncate 改的是文件大小，不是当前游标

f.Truncate(size) 接收一个 int64 长度。目标长度小于当前长度时，文件会被缩短；目标长度大于当前长度时，文件长度会被扩展。官方契约还明确说明：这个调用不会改变文件的 I/O offset。

因此不要把“长度已经变了”误认为“下一次 Write 会从文件头开始”。如果后续操作依赖固定位置，应单独调用 Seek，不要期待 Truncate 自动重置游标。

缩短和扩展都只需要一个目标长度

下面的最小写法先打开文件，再读取原始长度，调用 Truncate，最后再次读取长度。示例用同一个函数覆盖缩短与扩展两种情况：

package main

import (
    "fmt"
    "os"
)

func resizeFile(path string, target int64) error {
    // 读写方式打开，保证 Truncate 有权限修改文件长度。
    f, err := os.OpenFile(path, os.O_RDWR|os.O_CREATE, 0o644)
    if err != nil {
        return fmt.Errorf("打开文件失败: %w", err)
    }
    // 及时关闭句柄，避免批量处理时耗尽文件描述符。
    defer f.Close()

    before, err := f.Stat()
    if err != nil {
        return fmt.Errorf("读取原始长度失败: %w", err)
    }
    if target  %d，目标 %d\n", before.Size(), after.Size(), target)
    return nil
}

传入比原长度小的 target 会丢掉尾部内容；传入更大的值会让文件变长，但新增区域不是业务层已经写入的记录。若扩展后的区域必须包含确定内容，应在截断后显式写入，并把写入错误单独处理。

代码中的 Stat 只是为了让调用方得到前后长度，不是 Truncate 成功的唯一判断。真正的操作结果仍应以 Truncate 返回的 error 为准。

已经有文件句柄时优先用方法调用

标准库还提供 os.Truncate(path, size)。它适合只掌握路径、并且不需要复用已打开文件对象的简单场景。若代码已经完成了打开、权限控制或句柄复用，继续使用 f.Truncate 更容易把资源生命周期和错误上下文放在一起。

两种入口都要注意权限和路径错误。对已打开文件来说，方法返回的错误会包装为 *os.PathError；调用方可以保留原错误链，再用 errors.Is 或 errors.As 做分类。不要只把错误转换成一段字符串后再判断。

发布前要检查的四个边界

• 长度单位：size 是字节数，不是行数、字符数或结构体条数。
• 负数参数：先拒绝负长度，避免把业务输入错误带到系统调用层。
• 偏移位置：截断后需要继续读写时，按业务需要显式 Seek 到目标位置。
• 失败处理：保留包装后的错误，并确认文件句柄最终关闭；不要因为 Stat 读到了长度就忽略 Truncate 的返回值。

可以把回归检查压缩成一句话：目标长度是否正确、后续 I/O 是否从预期偏移继续、失败时是否能定位路径和权限、批量循环是否释放了句柄。围绕这四点检查，通常就能避免把文件截断问题误判成编码或写入顺序问题。

相关问题

Truncate 会把当前文件偏移重置为 0 吗？

不会。(*os.File).Truncate 改变文件大小，不改变 I/O offset；需要新位置时请显式调用 Seek。

扩展文件后新增内容是什么？

扩展只改变长度，不等于写入了业务数据。需要确定字节内容时，应再执行明确的写入操作并检查返回错误。