讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

AniShort
AniShort

AI短剧协同制作平台

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

酷枫吖_5942

酷枫吖_5942

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

|

646人浏览过

|

来源于php中文网

原创

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

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

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

Golang Uber Dig
Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等

下载

立即学习“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 ),必须检查并重试未写完的部分,除非你确定目标 <code>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 使用

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

热门AI工具

更多
蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

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

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

539

2024.02.23

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

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

616

2024.02.23

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

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

1316

2024.02.23

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

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

811

2024.03.05

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

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

1926

2024.05.21

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

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

5514

2025.06.09

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

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

2554

2025.06.10

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

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

4406

2025.06.17

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

120

2026.11.12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go-Zero HTTP服务开发指南
Go-Zero HTTP服务开发指南

共0课时 | 0人学习

Go-Zero goctl安装与使用手册
Go-Zero goctl安装与使用手册

共0课时 | 0人学习

Go-Zero框架快速开始指南
Go-Zero框架快速开始指南

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn