当前位置：首页 > 文章列表 > Golang > Go教程 > Go io.MultiWriter怎样把一次写入分发到多个目标为什么结果为空或不符合预期

Go io.MultiWriter怎样把一次写入分发到多个目标为什么结果为空或不符合预期

来源：17golang原创 2026-11-09 17:14:17 0浏览收藏

我第一次用 io.MultiWriter 是为了把一份审计文本同时写进内存缓冲区和文件。代码看起来只是把几个目标放进一个函数，实际排查时却很容易遇到两个现象：调用成功了，但从错误的对象读取，结果像是空的；或者前一个目标出错后，后面的目标没有任何内容。

先给结论：io.MultiWriter 返回的是一个组合后的 io.Writer，它不会替你保存一个可读取的总缓冲区。每次 Write 会按传入顺序写入各个目标；某个目标返回错误后，本次写入立即停止，并把错误交给调用方。

这篇只记住三点

结果要从传入的具体 Writer 读取，例如 *strings.Builder 或 *bytes.Buffer。
组合 Builder、Buffer 和文件时优先传指针，并检查 n 与 err。
MultiWriter 是顺序分发器，不是带重试和隔离能力的并发 fan-out。

官方文档入口：https://pkg.go.dev/io

io.MultiWriter 返回的到底是什么

它的签名是 io.MultiWriter(writers ...io.Writer) io.Writer。也就是说，返回值的职责仍然是接受 Write([]byte)，而不是提供 String()、Bytes() 或“读取全部分发结果”的方法。

所以排查“结果为空”时，第一件事不是读取 MultiWriter 本身，而是回到传入的目标对象。下面这张图只表达对象和接口的静态关系，不是运行截图或执行证据。

io.MultiWriter、io.Writer 与多个具体写入目标的静态结构说明图 — 图1：静态结构说明图，查看一次写入与多个 Writer 目标之间的组合关系。

还有一个常见误区是把“分发”理解成“并发”。官方定义是逐个写入列出的 Writer；如果业务需要某个目标慢了也不影响其它目标，就不能只靠 MultiWriter 解决。

怎样把同一份数据写进多个目标

内存目标和文件目标都实现了 io.Writer，可以先组合，再把这个组合 Writer 交给 io.WriteString、io.Copy 或自己的写入函数：

package main

import (
    "bytes"
    "fmt"
    "io"
    "os"
    "strings"
)

func fanout() error {
    var text strings.Builder
    var memory bytes.Buffer

    // 文件是额外的落盘目标；创建失败时不要继续组装 Writer。
    file, err := os.Create("audit.log")
    if err != nil {
        return err
    }
    // 退出函数前关闭文件，避免只看到内存结果却遗漏文件资源。
    defer file.Close()

    // 传入三个具体 Writer，MultiWriter 只负责组合它们的 Write 方法。
    writer := io.MultiWriter(&text, &memory, file)

    // 一次 Write 会被依次交给三个目标；必须保留返回值判断错误。
    n, err := io.WriteString(writer, "request accepted\n")
    if err != nil {
        return err
    }
    if n == 0 {
        return fmt.Errorf("没有写入任何字节")
    }

    // 结果从原始目标读取，而不是从 writer 读取。
    fmt.Print(text.String())
    fmt.Print(memory.String())
    return nil
}

这里的关键不是把目标数量写成三个，而是保证每个目标的生命周期和错误都可控。strings.Builder、bytes.Buffer 都使用指针传入，后面读取时也读取原变量。文件则要单独负责关闭。