Go io.MultiReader 如何拼接多个输入流

需要把多个文件片段、内存字符串或网络响应按顺序交给同一个消费函数时，Go 不必先把它们全部读进内存。io.MultiReader 会把多个 io.Reader 视为一条连续输入：前一个 Reader 返回 io.EOF 后才切换到下一个，所有输入耗尽才返回最终的 EOF；如果某个 Reader 返回其他错误，读取会在该处停止。

把多个 Reader 变成一条连续输入

最小用法是把多个实现了 io.Reader 的对象作为可变参数传入。下面三个 strings.Reader 只提供片段内容，MultiReader 不会改变它们的类型，只返回一个新的 io.Reader 视图。

package main

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

func main() {
	// 每个 Reader 代表一段独立输入，MultiReader 保留参数顺序。
	joined := io.MultiReader(
		strings.NewReader("header\n"),
		strings.NewReader("body\n"),
		strings.NewReader("footer\n"),
	)

	// 组合后的 Reader 可以直接交给已有的复制函数。
	if _, err := io.Copy(os.Stdout, joined); err != nil {
		panic(err)
	}
}

输出会依次出现 header、body、footer。这里的换行来自每个字符串本身；如果片段没有换行，MultiReader 不会替你补分隔符。对于 HTTP 响应、压缩包片段或上传分块，这种“原样连接”通常正是需要的行为。

顺序读取时，EOF 和错误怎么传递

可以把它理解成一个带有当前位置的 Reader：当前 Reader 还没结束时，后面的 Reader 不会被读取；当前 Reader 报告 EOF 时，组合层继续尝试下一个。调用方只需要处理组合层返回的 n 和 err，不必自己写切换循环。

这也解释了一个常见误区：MultiReader 不是“把所有数据提前拼成 []byte”。它按需读取，适合把多个大输入交给流式消费者。另一方面，Reader 的顺序是固定的，不适合需要并行拉取、按时间合并或随机访问的场景。

文件输入要自己管理关闭时机

组合文件时，打开动作和关闭动作仍属于调用方。io.MultiReader 只持有 Reader，不会替你调用 Close。因此可以先打开文件、用 defer 确保函数返回时关闭，再把文件 Reader 交给组合层：

func concatFiles(dst io.Writer, paths ...string) error {
	readers := make([]io.Reader, 0, len(paths))
	for _, path := range paths {
		file, err := os.Open(path)
		if err != nil {
			return fmt.Errorf("打开 %s: %w", path, err)
		}
		// 文件生命周期由当前函数负责，MultiReader 不会自动 Close。
		defer file.Close()
		readers = append(readers, file)
	}

	// 组合层只负责顺序读取，错误仍交给调用方处理。
	_, err := io.Copy(dst, io.MultiReader(readers...))
	return err
}

生产代码还应根据项目的错误策略处理 Close 返回值，并评估一次打开太多文件的风险。若文件数量很大，可以改成自定义 Reader，按需打开和关闭当前文件，避免一次持有过多文件描述符。

需要换行或并发时，不要误用 MultiReader

如果业务要求每个片段之间强制加入换行、长度前缀或协议分隔符，应显式加入一个 Reader，例如在相邻片段之间插入 strings.NewReader("\n")。如果目标是同时写入多个输出端，应看 io.MultiWriter；如果目标是并行读取后按时间或序号合并，则需要额外的并发协调结构。选择 API 前先确认“顺序原样连接”是不是实际需求。

常见问题

io.MultiReader 会自动关闭底层文件吗？

不会。文件、网络连接等资源必须由打开它们的代码负责关闭。

多个 Reader 之间会自动添加空格或换行吗？

不会。它只连接字节流，分隔符必须由调用方作为输入片段显式提供。

遇到一个 Reader 的普通错误后还会继续下一个吗？

不会。非 EOF 错误会返回给调用方并停止继续读取，是否重试应由业务层决定。