io.Pipe用于Golang中goroutine间同步数据流,实现io.Reader和io.Writer接口。1. 创建r, w := io.Pipe()配对读写端。2. 写操作需在独立goroutine中执行,避免阻塞读取导致死锁。3. 使用w.Close()正常关闭,w.CloseWithError(err)传递错误。4. 读取端通过io.Copy、bufio.Scanner等处理数据,遇io.EOF表示正常结束。5. 常见应用包括解耦生产消费者、动态HTTP请求体、实时压缩传输如gzip.NewWriter(w)配合使用。示例展示了向管道写入字符串并扫描输出的完整流程。

在Golang中,io.Pipe 是一种用于连接两个goroutine之间数据流的同步管道。它实现了 io.Reader 和 io.Writer 接口,非常适合在不使用缓冲通道或外部文件的情况下实现内存中的数据传递。下面介绍如何正确使用 io.Pipe 来处理数据流。
创建一个基本的io.Pipe
io.Pipe() 返回一个 *io.PipeReader 和 *io.PipeWriter,它们是一对配对的读写端。写入写入端的数据可以从读取端读出。
示例代码:
package main
import (
"io"
"log"
"os"
)
func main() {
// 创建一个pipe
r, w := io.Pipe()
// 启动一个goroutine向管道写入数据
go func() {
defer w.Close()
_, err := w.Write([]byte("hello from pipe\n"))
if err != nil {
log.Println("写入错误:", err)
}
}()
// 从管道读取数据并输出到标准输出
_, err := io.Copy(os.Stdout, r)
if err != nil {
log.Println("读取错误:", err)
}
r.Close()
}
结合其他io操作使用Pipe
你可以将 io.Pipe 与其他 io 工具组合使用,比如 io.Copy、bufio.Scanner 或压缩库等。
立即学习“go语言免费学习笔记(深入)”;
例如,实时处理写入的数据流:
go func() {
defer w.Close()
for _, msg := range []string{"first\n", "second\n", "third\n"} {
w.Write([]byte(msg))
}
}()
scanner := bufio.NewScanner(r)
for scanner.Scan() {
log.Println("收到:", scanner.Text())
}
if scanner.Err() != nil {
log.Println("扫描错误:", scanner.Err())
}
处理错误与关闭管道
如果写入端发生错误或提前关闭,读取端会收到相应的错误。推荐使用 w.CloseWithError(err) 显式传递错误,这样读取端能感知异常状态。
常见做法:
- 写入完成后调用
w.Close()表示正常结束。 - 遇到错误时调用
w.CloseWithError(someError)。 - 读取端检测到
io.EOF表示正常关闭,其他错误需处理。
实际应用场景
io.Pipe 常用于以下场景:
- 将生成数据的函数与消费数据的函数解耦(如日志处理)。
- 作为
http.Request的 body 输入源,动态生成请求体。 - 与
gzip等压缩包配合,实时压缩传输数据。
例如,发送动态生成的gzip数据:
r, w := io.Pipe()
gz := gzip.NewWriter(w)
go func() {
defer gz.Close()
defer w.Close()
gz.Write([]byte("大量待压缩数据"))
}()
req, _ := http.NewRequest("POST", "http://example.com", r)
client := &http.Client{}
resp, _ := client.Do(req)
基本上就这些。只要记得读写不能在同一个goroutine里阻塞执行,io.Pipe 就能安全高效地传递数据流。










