0

0

如何使用Golang io包读写数据_Golang io Reader Writer示例

P粉602998670

P粉602998670

发布时间:2026-01-13 12:46:02

|

626人浏览过

|

来源于php中文网

原创

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

如何使用golang io包读写数据_golang io reader writer示例

为什么 io.Readerio.Writer 不是具体类型而是接口

因为 Go 的 io.Readerio.Writer 是接口,不是结构体或函数——它们只定义行为:Read([]byte)Write([]byte)。这意味着任何实现了这两个方法的类型,都能被当作 io.Readerio.Writer 使用,比如 *os.Filebytes.Buffernet.Conn,甚至你自己写的结构体。

这种设计让代码高度可组合:你写一个处理 io.Reader 的函数,它就能读文件、读 HTTP body、读内存字节,无需改一行逻辑。

  • 别试图实例化 io.Reader —— 它不能 new(io.Reader),只能传入已实现它的值
  • 常见误用:把 string 直接当 io.Reader 传,会编译失败;得先转成 strings.NewReader(s)
  • io.ReaderRead 方法返回 (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

手动读写时怎么避免死循环和截断

手动调用 ReadWrite 很灵活,但也容易漏掉关键边界条件。典型问题包括:忽略 err 导致无限循环、把 n == 0 当作 EOF、没处理部分写入。

白果AI论文
白果AI论文

论文AI生成学术工具,真实文献,免费不限次生成论文大纲 10 秒生成逻辑框架,10 分钟产出初稿,智能适配 80+学科。支持嵌入图表公式与合规文献引用

下载

立即学习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.ReadFullio.WriteString 这类辅助函数该怎么选

Go 的 io 包提供了不少“带语义”的封装函数,省去手动判断逻辑,但适用场景很明确,乱用反而引入 bug。

  • io.ReadFull(r, buf):要求必须读满 len(buf) 字节,否则返回 io.ErrUnexpectedEOF 或其他错误。适合解析固定长度头(如二进制协议)
  • io.WriteString(w, s):比 w.Write([]byte(s)) 略快(避免重复分配),且更易读。但仅适用于字符串,不支持 fmt.Sprintf 那种格式化
  • io.MultiReaderio.MultiWriter:合并多个 Reader/Writer,常用于日志同时写文件+网络,但要注意并发安全 —— 它们本身不加锁,需外部同步
  • 别用 io.ReadAll 读不可信输入(如 HTTP body)——没有长度限制,可能 OOM;应配合 http.MaxBytesReader 使用

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

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

178

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

226

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

337

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

208

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

388

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

195

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

189

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

192

2025.06.17

php与html混编教程大全
php与html混编教程大全

本专题整合了php和html混编相关教程,阅读专题下面的文章了解更多详细内容。

3

2026.01.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go 教程
Go 教程

共32课时 | 3.6万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号