Go Academy · 课时

带缓冲的写入器

Q: 「带缓冲的写入器」这节课中我会学到什么？

批量写入 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

批量写入

带缓冲的写入器 是 CoddyKit 上的免费 Go Academy 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

为什么要进行 Buffer 写入

与读取一样，每次小量写入都可能触发系统调用。bufio.Writer 会将写入内容收集到内存中，然后分块刷新。

重要：如果不调用 Flush()，缓冲的数据就会丢失。

创建 bufio.Writer

包装任何 io.Writer。这里我们包装 os.Stdout。

package main

import (
	"bufio"
	"os"
)

func main() {
	w := bufio.NewWriter(os.Stdout)
	w.WriteString("Hello buffered\n")
	w.Flush()
}

不要忘记 Flush

如果没有调用 Flush()，您的输出可能永远不会显示。常见的写法是 defer w.Flush()。

package main

import (
	"bufio"
	"os"
)

func main() {
	w := bufio.NewWriter(os.Stdout)
	defer w.Flush()
	w.WriteString("written via defer\n")
}

写入 Bytes 和字符串

对字节切片使用 Write，对字符串使用 WriteString，对单个值使用 WriteByte 和 WriteRune。

package main

import (
	"bufio"
	"os"
)

func main() {
	w := bufio.NewWriter(os.Stdout)
	w.Write([]byte("bytes "))
	w.WriteString("string ")
	w.WriteRune('!')
	w.WriteByte('\n')
	w.Flush()
}

检查缓冲区状态

Buffered() 报告正在等待的字节数，而 Available() 报告剩余的可用空间。

package main

import (
	"bufio"
	"fmt"
	"os"
)

func main() {
	w := bufio.NewWriter(os.Stdout)
	w.WriteString("abc")
	fmt.Fprintf(os.Stderr, "buffered: %d\n", w.Buffered())
	w.Flush()
}

缓冲区满时自动 Flush

缓冲区填满时，bufio.Writer 会自动刷新。对于最后剩余的部分缓冲数据，您仍然必须在结尾调用 Flush()。

自定义 Buffer 大小

bufio.NewWriterSize(w, size) 设置容量。更大的缓冲区可以降低刷新频率。

package main

import (
	"bufio"
	"os"
)

func main() {
	w := bufio.NewWriterSize(os.Stdout, 8192)
	w.WriteString("custom size buffer\n")
	w.Flush()
}

使用 Fprintf 进行格式化写入

由于 bufio.Writer 是一个 io.Writer，您可以将它传给 fmt.Fprintf，以生成格式化的缓冲输出。

package main

import (
	"bufio"
	"fmt"
	"os"
)

func main() {
	w := bufio.NewWriter(os.Stdout)
	for i := 1; i <= 3; i++ {
		fmt.Fprintf(w, "line %d\n", i)
	}
	w.Flush()
}

处理写入错误

错误可能会在后续写入或调用 Flush() 时出现。请始终检查 Flush() 返回的错误。

package main

import (
	"bufio"
	"fmt"
	"os"
)

func main() {
	w := bufio.NewWriter(os.Stdout)
	w.WriteString("data\n")
	if err := w.Flush(); err != nil {
		fmt.Fprintln(os.Stderr, "flush failed:", err)
	}
}

批量进行多次写入

真正的优势在于：经过缓冲后，紧密循环中的多次小量写入会变成一次或少数几次系统调用。

package main

import (
	"bufio"
	"os"
)

func main() {
	w := bufio.NewWriter(os.Stdout)
	defer w.Flush()
	for i := 0; i < 5; i++ {
		w.WriteString("x")
	}
	w.WriteByte('\n')
}

最佳实践

始终调用 Flush()（或使用 defer）
检查 Flush() 返回的错误，而不只是检查每次写入的错误
根据工作负载设置合适的缓冲区大小

快速检查

测试您对带缓冲写入器的了解。

回顾

您已经学会了如何使用 bufio.Writer 批量进行写入。

NewWriter / NewWriterSize
Write、WriteString、WriteByte、WriteRune
可与 fmt.Fprintf 配合使用
始终调用 Flush() 并检查其错误

常见问题解答

「带缓冲的写入器」课时是免费的吗？

是的 — 「带缓冲的写入器」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「带缓冲的写入器」这节课中我会学到什么？

批量写入你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「带缓冲的写入器」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗？

能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Go Academy