io.MultiWriter可将数据同时写入多个目标，如文件、标准输出或网络连接。它接收多个io.Writer并返回一个组合writer，每次Write调用会将数据发送到所有writer中。若其中一个writer出错，Write返回该错误但不影响其他writer的写入尝试。常用于日志记录、调试输出等场景。示例包括同时输出到终端和文件：通过os.Stdout与*os.File构建MultiWriter，并设置log输出目标，实现日志双写。进阶应用涵盖写入多个bytes.Buffer用于测试或缓存复制，以及向多个HTTP响应流分发相同内容，适用于服务网关或镜像场景。注意事项包括：写入是同步的，性能受限于最慢的writer；一旦某writer失败，Write返回错误，后续写入可能不完整；适合低频高可靠场景，高频场景建议加缓冲或异步处理；避免加入不可靠的网络连接除非能处理错误；可结合io.TeeReader实现读写双路径复制。总之，io.MultiWriter提供简洁优雅的多路输出方案，代码清晰易维护，合理使用可在实际项目中发挥重要作用。
在Go语言中，io.MultiWriter 是一个非常实用的功能，它允许你将数据同时写入多个目标，比如文件、标准输出、网络连接等。这个特性在日志记录、调试输出或需要多重备份写入的场景中特别有用。
什么是 io.MultiWriter？
io.MultiWriter 接受多个 io.Writer 接口实现，并返回一个组合后的 writer。每次调用 Write 时，数据会被发送到所有传入的 writer 中。如果其中一个 writer 返回错误，Write 操作也会返回该错误（但不会中断其他 writer 的写入尝试）。
函数签名如下：
func MultiWriter(writers ...Writer) Writer
基本使用示例：同时输出到控制台和文件
下面是一个常见场景：把日志信息既打印到终端，又保存到本地文件。
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"io"
"log"
"os"
)
func main() {
// 打开日志文件
file, err := os.Create("app.log")
if err != nil {
log.Fatal(err)
}
defer file.Close()
// 创建 MultiWriter，同时写入 stdout 和文件
multiWriter := io.MultiWriter(os.Stdout, file)
// 使用 log 设置输出目标
log.SetOutput(multiWriter)
// 写入日志
log.Println("这是一条同时出现在终端和文件中的日志")
}
运行后你会看到终端输出内容，同时 app.log 文件中也记录了相同的信息。
进阶应用：写入多个缓冲区或网络连接
MultiWriter 不仅限于文件和标准输出，它可以用于任何实现了 io.Writer 的类型。
例如，将数据写入两个 bytes.Buffer：
package main
import (
"bytes"
"fmt"
"io"
)
func main() {
var buf1, buf2 bytes.Buffer
writer := io.MultiWriter(&buf1, &buf2)
data := []byte("hello world")
writer.Write(data)
fmt.Printf("Buffer 1: %s\n", buf1.String()) // 输出: hello world
fmt.Printf("Buffer 2: %s\n", buf2.String()) // 输出: hello world
}
这种模式可用于测试、缓存复制或数据广播。
再比如，向多个 HTTP 响应流写入相同内容（如服务网关场景）：
// 假设你有多个 http.ResponseWriter // w1, w2 都是 http.ResponseWriter // multi := io.MultiWriter(w1, w2) // multi.Write(responseData)
这样可以实现响应复制分发，常用于调试代理或镜像服务。
注意事项与最佳实践
- 所有写入操作是同步进行的，性能取决于最慢的那个 writer
- 一旦某个 writer 返回错误，整个 Write 调用会返回错误，后续写入可能不完整
- 适合低频高可靠场景，高频写入时建议加 buffer 或异步处理
- 避免将不可靠的目标（如网络连接）直接加入 MultiWriter，除非你准备好处理失败
- 可结合 io.TeeReader 实现读写双路径复制
基本上就这些。io.MultiWriter 提供了一种简洁优雅的方式实现多路输出，代码清晰且易于维护。只要注意性能和错误处理边界，就能在实际项目中发挥很好作用。
