Writer 接口
写入任意目标
Writer 接口 是 CoddyKit 上的免费 Go Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。
写入任意目标
io.Writer 统一了所有输出目标：文件、网络、缓冲区、标准输出和 HTTP 响应。一个接口，多个目标。
接口定义
契约如下：
Write(p []byte) (n int, err error)
它写入 p，并返回已写入的字节数以及可能出现的错误。
写入 Buffer
bytes.Buffer 实现了 io.Writer，并将输出收集到内存中。
package main
import (
"bytes"
"fmt"
)
func main() {
var buf bytes.Buffer
buf.Write([]byte("Hello, "))
buf.WriteString("Writer!")
fmt.Println(buf.String())
}写入标准输出
os.Stdout 是一个 io.Writer。os.Stderr 也是如此。
package main
import (
"io"
"os"
)
func main() {
io.WriteString(os.Stdout, "straight to stdout\n")
}fmt.Fprintf 与写入器
Fprint 系列函数会将格式化文本写入任何 io.Writer。
package main
import (
"bytes"
"fmt"
)
func main() {
var buf bytes.Buffer
fmt.Fprintf(&buf, "x = %d\n", 42)
fmt.Print(buf.String())
}短写入错误
如果 Write 返回 n < len(p) 且错误为 nil，这就违反了契约，称为短写入。遵循契约的写入器会将其报告为 io.ErrShortWrite。
接受写入器的函数
编写接收 io.Writer 的函数，这样同一套逻辑就能面向文件、缓冲区或网络。
package main
import (
"fmt"
"io"
"os"
)
func greet(w io.Writer, name string) {
fmt.Fprintf(w, "Hi, %s\n", name)
}
func main() {
greet(os.Stdout, "Ada")
}为测试解耦输出
由于函数接收 io.Writer，测试可以将输出捕获到 bytes.Buffer 中并对其进行断言——无需接触真实文件。
package main
import (
"bytes"
"fmt"
)
func emit(w *bytes.Buffer) { fmt.Fprint(w, "result") }
func main() {
var b bytes.Buffer
emit(&b)
fmt.Println("captured:", b.String())
}写入字节与字符串
Write 接收字节切片；io.WriteString 是用于字符串的便捷方法，并且在写入器支持该方法时可以避免一次内存分配。
package main
import (
"io"
"os"
)
func main() {
os.Stdout.Write([]byte("bytes\n"))
io.WriteString(os.Stdout, "string\n")
}始终检查写入错误
写入文件或套接字可能在数据流中途失败（磁盘已满、连接断开）。请检查返回的错误，尤其是在使用非内存写入器时。
一个接口，多个目标
- 文件、缓冲区、stdout/stderr
- HTTP 响应写入器
- 压缩和加密包装器
它们都满足 io.Writer，因此您的代码无需依赖具体的目标位置。
快速检查
请测试您对 io.Writer 的了解。
回顾
您学习了核心输出接口。
Write(p []byte) (int, error)就是完整契约bytes.Buffer、os.Stdout和 HTTP 响应都实现了它- 可与
fmt.Fprintf和io.WriteString配合使用 - 接收
io.Writer，即可构建灵活且易于测试的 API
常见问题解答
「Writer 接口」课时是免费的吗？
是的 — 「Writer 接口」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。
「Writer 接口」这节课中我会学到什么？
写入任意目标 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Go Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「Writer 接口」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Go Academy 课中编写并运行代码吗？
能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。