Go io.MultiWriter 怎么同步写入多个目标

Go 里要把同一份数据写到文件、日志缓冲区或其他输出目标，可以把它们包装成一个 io.MultiWriter。它不是并发广播器，而是按照传入顺序逐个调用每个目标的 Write：前一个成功后才写下一个；任一目标返回错误，当前写入立即停止。因此它适合“一个写入动作、多个同步副本”的场景。

Go io.MultiWriter 的同步写入模型

io.MultiWriter 接收多个 io.Writer，返回一个仍然满足 io.Writer 接口的对象。调用一次 Write(p) 时，包装器把同一个字节切片交给每个目标，但调用关系是串行的。目标列表的顺序也就是故障传播顺序，不能把它理解成多个 goroutine 同时发送。

这带来一个很实际的选择：如果文件写入必须成功后才允许进入内存缓冲区，就把文件 Writer 放在前面；如果内存记录只是旁路信息，也可以把它放在后面。顺序表达的是失败时的优先级，不只是代码排版。

用 io.MultiWriter 同时写文件和缓冲区

下面的例子把一份报告内容同时写入文件和 strings.Builder。代码没有启动并发任务，io.Copy 只需要面对一个 Writer；文件关闭仍由调用方负责。

package main

import (
    "io"
    "log"
    "os"
    "strings"
)

func main() {
    // 文件是主目标，缓冲区用于后续摘要或测试断言。
    file, err := os.Create("report.txt")
    if err != nil {
        log.Fatal(err)
    }
    defer file.Close() // MultiWriter 不负责关闭底层 Writer。

    var memory strings.Builder
    targets := io.MultiWriter(file, &memory)

    // Copy 会把 Reader 的内容交给两个目标，任一写入失败都会返回错误。
    if _, err := io.Copy(targets, strings.NewReader("日报：同步写入\n")); err != nil {
        log.Fatal(err)
    }
    log.Print(memory.String())
}

这里的两个目标都会收到相同字节，memory.String() 可以直接得到内存副本。若目标是网络连接、管道或自定义 Writer，还要把它们自己的超时、关闭和重试策略放在外层处理。

错误停止与部分写入边界

官方接口约定是：某个 Writer 返回错误时，MultiWriter 返回该错误，并停止向后续 Writer 写入。于是一次调用可能出现“前两个目标已有内容，第三个目标为空”的部分成功。它没有跨目标回滚能力，也不会重新执行已经成功的目标。

如果业务要求所有副本要么全部成功、要么全部没有结果，不能只靠 MultiWriter。应先写临时文件再原子替换，或为每个目标记录事务状态并设计补偿动作。

并发与迁移检查清单

迁移手写的多次 Write 前，先确认四件事：第一，目标是否必须按固定顺序落盘；第二，失败后是否允许部分副本存在；第三，多个 goroutine 是否可能同时使用同一个 MultiWriter；第四，所有底层对象由谁关闭。io 包的接口默认不替实现提供并行安全，若共享 Writer，需要外层互斥或独立实例。

若目标本身是带缓冲的 Writer，先完成 Flush 再判断最终结果；若目标实现了网络重试，避免在 MultiWriter 外层又无条件重试整批数据，否则可能让已成功的目标重复写入。这个边界比减少几行代码更重要。

相关问题

io.MultiWriter 是异步写入吗？

不是。一次写入会按传入顺序逐个调用目标，耗时取决于这些目标的串行总耗时。

某个目标失败后还能继续写其他目标吗？

同一次 Write 不会继续。若业务允许“尽力写入”，需要自己遍历目标并分别记录错误。

io.MultiWriter 会自动关闭文件吗？

不会。它只包装 Write，底层文件、连接和缓冲 Writer 的关闭或刷新仍由调用方负责。