io.Reader 和 io.Writer 是接口而非具体类型,因它们仅定义 Read([]byte) 和 Write([]byte) 行为,支持任意实现类型的灵活组合与复用。

为什么 io.Reader 和 io.Writer 不是具体类型而是接口
因为 Go 的 io.Reader 和 io.Writer 是接口,不是结构体或函数——它们只定义行为:Read([]byte) 和 Write([]byte)。这意味着任何实现了这两个方法的类型,都能被当作 io.Reader 或 io.Writer 使用,比如 *os.File、bytes.Buffer、net.Conn,甚至你自己写的结构体。
这种设计让代码高度可组合:你写一个处理 io.Reader 的函数,它就能读文件、读 HTTP body、读内存字节,无需改一行逻辑。
- 别试图实例化
io.Reader—— 它不能new(io.Reader),只能传入已实现它的值 - 常见误用:把
string直接当io.Reader传,会编译失败;得先转成strings.NewReader(s) -
io.Reader的Read方法返回(n int, err error),必须检查err == io.EOF来判断流结束,不能只看n == 0
用 io.Copy 安全地从 Reader 写到 Writer
io.Copy 是最常用也最安全的搬运函数,内部自动处理分块读写、错误传播和 EOF 判断,比手写 for { Read(); Write() } 少出错得多。
func main() {
src := strings.NewReader("hello world")
dst := &bytes.Buffer{}
n, err := io.Copy(dst, src)
if err != nil {
log.Fatal(err)
}
fmt.Printf("copied %d bytes: %q\n", n, dst.String())
// 输出:copied 11 bytes: "hello world"
}
-
io.Copy默认每次最多读取 32KB(io.DefaultBufSize),对大文件友好,不会爆内存 - 如果目标
Writer是网络连接或磁盘文件,io.Copy会自动处理写满、阻塞、临时错误重试等细节 - 不要用
io.Copy处理需要修改内容的场景(如加前缀)——得用io.CopyN或手动Read/Write
手动读写时怎么避免死循环和截断
手动调用 Read 或 Write 很灵活,但也容易漏掉关键边界条件。典型问题包括:忽略 err 导致无限循环、把 n == 0 当作 EOF、没处理部分写入。
立即学习“go语言免费学习笔记(深入)”;
buf := make([]byte, 64)
for {
n, err := r.Read(buf)
if err != nil {
if err == io.EOF {
break // 正确:显式检查 EOF
}
return err // 其他错误直接返回
}
if n == 0 {
continue // 安全起见,跳过零读(某些 Reader 可能返回)
}
if _, werr := w.Write(buf[:n]); werr != nil {
return werr
}
}
-
Read可能返回n > 0 && err == nil(正常),也可能n == 0 && err == io.EOF(流结束),还可能n == 0 && err != nil(出错) -
Write可能只写出部分字节(n ),必须检查并重试未写完的部分,除非你确定目标Writer总是全量写入(如bytes.Buffer) - 缓冲区大小不一定要 64 —— 常用 1KB–64KB,太小增加系统调用开销,太大浪费内存
io.ReadFull 和 io.WriteString 这类辅助函数该怎么选
Go 的 io 包提供了不少“带语义”的封装函数,省去手动判断逻辑,但适用场景很明确,乱用反而引入 bug。
-
io.ReadFull(r, buf):要求必须读满len(buf)字节,否则返回io.ErrUnexpectedEOF或其他错误。适合解析固定长度头(如二进制协议) -
io.WriteString(w, s):比w.Write([]byte(s))略快(避免重复分配),且更易读。但仅适用于字符串,不支持fmt.Sprintf那种格式化 -
io.MultiReader和io.MultiWriter:合并多个Reader/Writer,常用于日志同时写文件+网络,但要注意并发安全 —— 它们本身不加锁,需外部同步 - 别用
io.ReadAll读不可信输入(如 HTTP body)——没有长度限制,可能 OOM;应配合http.MaxBytesReader使用
接口抽象看似简单,但真正用好要理解每个函数的契约:它承诺什么、不承诺什么、谁负责清理、错误是否可恢复。这些细节在胶水代码里最容易被忽略。









