如何使用Golang实现文件追加操作_保证原有内容不被覆盖

使用 os.OpenFile 配合 os.O_APPEND | os.O_WRONLY | os.O_CREATE 可安全追加内容而不覆盖原有数据，需手动添加换行符，避免并发写入，大文件性能良好；日志场景推荐用 log 包。

在 Go 语言中，使用 os.OpenFile 并指定正确的标志位（os.O_APPEND | os.O_WRONLY | os.O_CREATE）即可安全追加内容，原有数据不会被覆盖。

使用 os.OpenFile 正确打开文件进行追加

关键在于传入的 flag 参数必须包含 os.O_APPEND —— 它会强制所有写入操作从文件末尾开始，无论当前文件指针位置如何。同时需搭配 os.O_WRONLY（只写）和 os.O_CREATE（文件不存在时自动创建）。

• 不要用 os.O_TRUNC：该标志会在打开时清空文件，导致原有内容丢失
• 避免仅用 os.O_WRONLY：没有 O_APPEND 时，写入会从文件开头覆盖已有字节
• 权限建议设为 0644（Unix-like 系统），确保可读可写，Windows 下该参数被忽略

完整示例代码

以下是一个安全、可复用的追加函数：

func appendToFile(filename, content string) error {
    f, err := os.OpenFile(filename, os.O_APPEND|os.O_WRONLY|os.O_CREATE, 0644)
    if err != nil {
        return err
    }
    defer f.Close()

    _, err = f.WriteString(content + "\n")
    return err
}

// 调用示例
err := appendToFile("log.txt", "user logged in")
if err != nil {
    log.Fatal(err)
}

注意事项与常见陷阱

追加看似简单，但几个细节容易引发问题：

• 换行符需手动添加：Go 不会自动补 \n，多次追加易出现连在一起的文本，建议统一加 \n 或 \r\n
• 并发写入不安全：多个 goroutine 同时追加同一文件可能造成内容交错；如需并发安全，应加锁或使用日志库（如 log 包配合 io.MultiWriter）
• 大文件追加性能良好：因 O_APPEND 由操作系统保证原子性，无需先 seek 到末尾，效率高且线程安全（单次 write 调用内）

替代方案：用 log 包做结构化追加

若用于日志场景，标准库 log 包更健壮：

• 自动加时间戳、换行和前缀
• 支持输出到任意 io.Writer，包括文件
• 天然适合多 goroutine 写入（内部带锁）

f, _ := os.OpenFile("app.log", os.O_APPEND|os.O_WRONLY|os.O_CREATE, 0644)
defer f.Close()

logger := log.New(f, "[INFO] ", log.LstdFlags)
logger.Println("Server started") // 自动换行+时间戳