Golangio包读写操作教程

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《Golang io包读写数据教程》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

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、没处理部分写入。

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 < len(p)），必须检查并重试未写完的部分，除非你确定目标 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 使用

接口抽象看似简单，但真正用好要理解每个函数的契约：它承诺什么、不承诺什么、谁负责清理、错误是否可恢复。这些细节在胶水代码里最容易被忽略。

终于介绍完啦！小伙伴们，这篇关于《Golangio包读写操作教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！