Go os.File.Truncate 清理覆盖写入后旧内容的处理方案

我在处理配置文件时遇到过一个很容易误判的现象：原内容是 production=true\nregion=cn\n，后来把它改成更短的 debug=false\n，写入没有报错，读回文件却还能看到旧的 region=cn。原因不是 Go 把字符串写错了，而是覆盖写只改写写入范围，不会自动把文件长度缩短。

正确的处理方式是：用可写句柄写入新内容，确认写入字节数后，以新内容末尾为长度调用 os.File.Truncate。它会改变文件大小，但不会改变当前 I/O 偏移；写入、截断和错误检查要放在同一条清晰的资源管理路径里。

覆盖写入为什么会留下文件尾部旧字节

文件有“当前位置”和“文件总长度”两个概念。假设旧文件长度是 32 字节，句柄从偏移 0 开始写入 13 字节，Write 只负责把这 13 字节放到偏移 0 到 12；文件总长度仍可能是 32，13 之后的内容自然还在。把写入位置移到文件头，并不等于把文件裁短。

用当前写入长度截断文件

如果新内容就是从文件开头完整重写，最稳妥的长度来自 Write 返回的 n，而不是用字符串长度猜测。下面的示例保留了错误优先级：写入失败时不继续截断，截断失败也不把它当成成功。

package main

import (
    "fmt"
    "os"
)

func replaceFile(path string, data []byte) error {
    // O_WRONLY 允许写入；不使用 O_TRUNC，便于展示写完后按实际长度截断。
    file, err := os.OpenFile(path, os.O_WRONLY|os.O_CREATE, 0o644)
    if err != nil {
        return fmt.Errorf("打开文件失败: %w", err)
    }
    defer file.Close() // 释放文件描述符；Close 错误可按业务需要单独记录。

    // 从文件头开始覆盖，避免沿用上一次操作留下的偏移。
    if _, err := file.Seek(0, 0); err != nil {
        return fmt.Errorf("定位文件头失败: %w", err)
    }
    n, err := file.Write(data)
    if err != nil {
        return fmt.Errorf("写入新内容失败: %w", err)
    }
    if n != len(data) {
        return fmt.Errorf("写入不完整: %d/%d 字节", n, len(data))
    }
    // n 是新内容长度；截断会保留前 n 字节并删除旧尾部。
    if err := file.Truncate(int64(n)); err != nil {
        return fmt.Errorf("清理旧尾部失败: %w", err)
    }
    return nil
}

这里的关键不是“调用了一个清理函数”，而是把截断长度绑定到实际写入结果。若数据由多个 Write 组成，应累计成功写入的字节数，或在所有写入结束后用明确的最终偏移作为长度。

O_TRUNC、覆盖写和 File.Truncate 怎么选

我通常按“是否允许先清空”来选方案。需要保留旧文件的一部分、再把尾部缩短时，使用 File.Truncate；每次打开都要从空文件开始生成时，可以在 OpenFile 中使用 os.O_TRUNC。如果只是追加日志，则用 os.O_APPEND，不要在追加模式下把截断当作去重手段。

几个容易遗漏的边界

第一，Truncate 不会改变 I/O offset，所以截断后如果还要继续写，必须明确下一次写入位置。第二，句柄以只读方式打开时，写入或截断都会失败，错误通常带有路径信息；不要只检查文件是否存在。第三，空数据也要处理：合法的 Truncate(0) 会得到空文件。第四，多进程或多 goroutine 同时写同一文件时，写入长度与截断长度可能来自不同版本，单次调用成功不代表整体内容一致，生产环境要配合锁、临时文件替换或版本化写入。

延伸问答

只调用 Write，为什么旧内容还在？

因为 Write 改写的是指定范围，文件长度不会因写入较短内容自动减少。

Truncate 会把当前读写位置移到文件尾吗？

不会。官方文档明确说明它改变文件大小但不改变 I/O offset，需要继续操作时自行定位。

什么时候直接使用 O_TRUNC？

当旧内容完全没有保留价值、打开文件时就可以清空，O_TRUNC 更直接；需要先写入并按最终长度裁剪时，用 File.Truncate 更可控。