io.writer 是一个接口定义，不是具体类型或流对象；只要实现 write([]byte) (int, error) 方法即满足该接口，常见实现有 *os.file、bytes.buffer 等，使用时无需创建，只需传入符合要求的类型。
io.Writer 是什么，不是什么
它只是一个接口定义，不是具体类型，更不是某种“流对象”。只要实现了 Write([]byte) (int, error) 方法的类型，就自动满足 io.Writer。别把它当成一个要“初始化”或“创建”的东西——你几乎从来不会直接 new 它，而是把已有类型（比如 *os.File、bytes.Buffer、http.ResponseWriter）传给需要 io.Writer 的函数。
常见错误现象：cannot use xxx (type *MyStruct) as type io.Writer in argument to writeSomething: *MyStruct does not implement io.Writer (missing Write method) —— 这说明你漏写了 Write 方法，或者签名不对（比如参数不是 []byte，或返回值少了一个 int）。
怎么写一个最小可用的 Writer 实现
实现 io.Writer 的关键只有两点：方法名必须是 Write，签名必须严格匹配。返回值里的 int 是实际写入字节数，不能随便返回 0 或 len(p)，否则调用方（比如 io.Copy）会认为写失败或截断。
- 参数
p []byte是只读切片，别改它的底层数组（除非你明确知道自己在做什么） - 返回的
int必须 ≤len(p)；如果写不完，应返回已写数量 +nil（非阻塞场景），或返回 0 + 具体错误（如io.ErrShortWrite） - 不要在
Write里做耗时操作（如网络请求、磁盘 sync），否则会卡住所有依赖它的逻辑（比如json.Encoder.Encode）
示例（丢弃所有输入的 writer）：
type NullWriter struct{}
func (NullWriter) Write(p []byte) (n int, err error) {
return len(p), nil // 不真写，但声明“全写完了”
}
为什么往 io.Writer 写数据有时不生效
最常被忽略的是：很多 io.Writer 实现自带缓冲，比如 bufio.Writer、gzip.Writer、json.Encoder 底层封装的 writer。它们不自动 flush，你得显式调用 Flush() 或关闭（Close()）才能真正落盘或发出去。
-
bufio.NewWriter(os.Stdout).WriteString("hello")→ 控制台可能没输出，加.Flush()就行 -
gzip.NewWriter(w).Write(data)→ 不Close()就会缺结尾校验和，解压失败 -
json.NewEncoder(w).Encode(v)→ 它自己不 flush，w 若是带缓冲的，得额外处理
另一个坑：某些 writer（如 http.ResponseWriter）一旦写 header 后就不能再改状态码或 header，但 Write 调用本身不报错，只是静默失效。
哪些类型天然满足 io.Writer，哪些容易混淆
天然满足的常见类型：*os.File、*bytes.Buffer、io.Discard、http.ResponseWriter、strings.Builder（注意不是 strings.Reader）、bufio.Writer。
容易误以为满足但其实不满足的：
-
string、[]byte：没Write方法，得转成bytes.NewReader（那是io.Reader）或用bytes.Buffer.WriteString -
fmt.Print*系列函数返回int和error，但它们不是方法，不能赋值给io.Writer变量 -
log.Logger本身不是io.Writer，但它有SetOutput方法接收io.Writer，别反着记
跨包传递时，优先传递 io.Writer 接口而非具体类型——这样你的函数才真正可测试（比如传 &bytes.Buffer{} 捕获输出），也避免强依赖 os 或 net/http。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
