

新闻资讯
技术教程io.Reader 和 io.Writer 是接口而非具体类型,因它们仅定义 Read([]byte) 和 Write([]byte) 行为,支持任意实现类型的灵活组合与复用。
io.Reader 和 io.Writer 不是具体类型而是接口因为 Go 的 io. 和
Readerio.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、没处理部分写入。
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)
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 使用接口抽象看似简单,但真正用好要理解每个函数的契约:它承诺什么、不承诺什么、谁负责清理、错误是否可恢复。这些细节在胶水代码里最容易被忽略。