Reader 接口
Go 输入输出的核心
Reader 接口 是 CoddyKit 上的免费 Go Academy 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。
Go I/O 的核心
io.Reader 是 Go 中统一所有输入的一个接口：文件、网络连接、字符串、压缩流等。
接受 io.Reader 的代码可以处理任何数据源。
接口定义
契约非常简短：
Read(p []byte) (n int, err error)
它会向 p 中填入最多 len(p) 个字节，返回实际填入的数量（n）以及一个错误。
从字符串读取
strings.NewReader 会将字符串转换为 io.Reader。
package main
import (
"fmt"
"strings"
)
func main() {
r := strings.NewReader("Hello")
buf := make([]byte, 5)
n, _ := r.Read(buf)
fmt.Printf("read %d bytes: %s\n", n, buf[:n])
}先处理 n、再处理错误
一次 Read 调用可能同时返回 n > 0 个字节和一个错误。请始终先处理这 n 个字节，再检查错误。
循环读取
大多数读取器都需要循环，因为一次 Read 返回的字节数可能少于请求的数量。
package main
import (
"fmt"
"io"
"strings"
)
func main() {
r := strings.NewReader("abcdef")
buf := make([]byte, 2)
for {
n, err := r.Read(buf)
if n > 0 {
fmt.Printf("%s ", buf[:n])
}
if err == io.EOF {
break
}
}
fmt.Println()
}io.ReadAll
当数据量较小且有明确上限时，io.ReadAll 会为您将全部数据读入字节切片。
package main
import (
"fmt"
"io"
"strings"
)
func main() {
r := strings.NewReader("read it all")
data, _ := io.ReadAll(r)
fmt.Println(string(data))
}从 Bytes 创建读取器
bytes.NewReader 包装一个字节切片；当数据已经位于内存中时，这非常有用。
package main
import (
"bytes"
"fmt"
"io"
)
func main() {
r := bytes.NewReader([]byte{72, 105})
data, _ := io.ReadAll(r)
fmt.Println(string(data))
}接受读取器的函数
请编写接受 io.Reader 而不是具体类型的函数。这样，同一个函数就可以从文件、套接字或测试字符串中读取数据。
package main
import (
"fmt"
"io"
"strings"
)
func countBytes(r io.Reader) int {
data, _ := io.ReadAll(r)
return len(data)
}
func main() {
fmt.Println(countBytes(strings.NewReader("hello")))
}io.EOF 不是错误
请将 io.EOF 视为数据流结束的正常信号，而不是失败。只有其他错误才表示真正的问题。
LimitReader
io.LimitReader(r, n) 包装一个读取器，使其在读取 n 个字节后停止，适合限制读取量。
package main
import (
"fmt"
"io"
"strings"
)
func main() {
r := io.LimitReader(strings.NewReader("abcdefgh"), 3)
data, _ := io.ReadAll(r)
fmt.Println(string(data))
}为什么一个接口更有优势
- 使代码与数据源解耦
- 使用字符串或字节进行测试非常简单
- 可以与 LimitReader、gzip 等包装器组合
快速检查
测试您对 io.Reader 的了解。
回顾
您已经学会了核心输入接口。
Read(p []byte) (int, error)就是完整契约- 循环直到
io.EOF；先处理 n 个字节 io.ReadAll、strings/bytes.NewReader、LimitReader- 在您的 API 中接受
io.Reader
常见问题解答
「Reader 接口」课时是免费的吗？
是的 — 「Reader 接口」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。
「Reader 接口」这节课中我会学到什么？
Go 输入输出的核心 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Go Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「Reader 接口」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Go Academy 课中编写并运行代码吗？
能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。