Go os.OpenFile O_APPEND 和 O_TRUNC 组合会发生什么

在 Go 里，os.OpenFile 的标志是按位组合的，但组合后并不是“每个标志都在写入时执行”。最容易混淆的是 O_APPEND 和 O_TRUNC：前者让每次写入定位到文件末尾，后者在打开可写文件时立即把已有内容截为零。两者同时出现时，已有文件通常会先被清空，随后写入从空文件末尾开始；它不会产生“保留旧内容并追加”的效果。

官方文档：https://pkg.go.dev/os#OpenFile

先分清 O_APPEND 与 O_TRUNC 各自改变什么

os.OpenFile(name, flag, perm) 要求先给出一个访问模式：O_RDONLY、O_WRONLY 或 O_RDWR 三者选一，其余标志再用按位或叠加。

所以 O_APPEND|O_TRUNC 的关键顺序是“打开阶段截断，写入阶段追加”。追加位置是在截断后的文件末尾，也就是偏移量 0；它不表示先读取旧内容再接着写。

用一个小工具明确组合结果

下面的示例只写一条短记录，便于分别替换 flags 观察设计意图。代码中的中文注释说明了访问模式、创建权限和错误清理点。

package main

import (
    "fmt"
    "os"
)

func main() {
    // O_WRONLY 指定只写；O_CREATE 允许文件不存在时创建。
    flags := os.O_WRONLY | os.O_CREATE | os.O_APPEND
    file, err := os.OpenFile("notes.log", flags, 0o644)
    if err != nil {
        // 打开失败时直接返回，避免对空指针调用 Close。
        fmt.Println("open failed:", err)
        return
    }
    defer file.Close() // 函数结束时释放文件描述符。

    if _, err := file.WriteString("ready\n"); err != nil {
        // 写入失败要保留错误，调用方才能决定重试或报警。
        fmt.Println("write failed:", err)
        return
    }
    fmt.Println("record appended")
}

把 flags 改成 os.O_WRONLY|os.O_CREATE|os.O_TRUNC，已有 notes.log 会在打开时先被清空；改成 os.O_WRONLY|os.O_CREATE|os.O_APPEND|os.O_TRUNC，依然先清空，随后第一条记录从空文件末尾写入。这个组合通常没有实际价值，除非你的明确目标就是“清空后以追加语义继续写”。

创建新文件与覆盖旧文件怎么选

按“旧内容是否保留”做第一轮判断即可：

• 生成配置、缓存快照或临时结果：O_WRONLY|O_CREATE|O_TRUNC，每次得到一份完整新内容。
• 写审计日志、任务记录或追加事件：O_WRONLY|O_CREATE|O_APPEND，保留已有内容。
• 要求文件名不能被占用：O_WRONLY|O_CREATE|O_EXCL，遇到已存在文件就按错误处理。

perm 只在创建新文件时有意义，常用的 0o644 表示创建者可读写、其他用户只读；已有文件的权限不会因为每次 OpenFile 都传入新值而自动重置。若程序需要跨平台，还应根据目标系统测试底层文件语义。

多协程追加时还要注意什么

Go 的 File 方法可以并发使用，但并发安全不等于业务记录天然完整。O_APPEND 解决的是每次写操作的定位，不能保证多段 Write 拼成的一条业务事件不会被其他写入穿插。因此日志记录最好先在内存中拼成一段完整字节，再一次 Write；需要跨进程协调时，还要配合专门的锁、单写者或队列。

func appendLine(file *os.File, message string) error {
    // 一次构造完整记录，避免把一行拆成多次写入。
    record := message + "\n"
    _, err := file.WriteString(record)
    return err // 由上层决定重试、记录失败或终止任务。
}

不要把 Seek 和 O_APPEND 混成“手动移动到末尾再写”的方案；追加语义应交给打开标志，业务层重点处理记录边界、错误和关闭。

常见问题与速查

O_TRUNC 会在 Write 时触发吗？不会。对可写的普通文件，它属于打开动作的一部分，所以即使后续没有成功写入，旧内容也可能已经被清空。

O_APPEND 能和 O_RDONLY 一起用吗？追加是写入行为，实际用途应配合 O_WRONLY 或 O_RDWR；访问模式仍要从三种基础模式中选择一种。

为什么追加日志没有换行？O_APPEND 不会替你添加分隔符。调用方必须把换行或其他记录边界写进单次记录。

记住一句话：O_APPEND 决定“写到哪里”，O_TRUNC 决定“打开时旧内容还在不在”，O_CREATE 决定“文件不存在能不能创建”。先按保留策略选标志，再补充错误处理和并发约束，组合就不容易出错。