io.WriteString 通过接口断言优化字符串写入：若 w 实现 stringWriter 接口则直接调用 WriteString，否则转为 []byte 后调用 Write，避免冗余转换，提升性能。
io.WriteString 写入字符串的正确姿势
io.WriteString 不是万能写入函数，它只接受 io.Writer 接口和 string 类型，不支持 []byte 或格式化。如果你传了 *os.File、bytes.Buffer 或 net.Conn 这类实现了 Write 方法的对象，它就能工作；但传 *os.Stdout 虽然合法，实际中要小心缓冲和换行。
- 必须确保目标
w已打开且可写（比如用os.OpenFile时加os.O_WRONLY|os.O_CREATE） - 写入后不会自动换行，要换行得显式拼接
"\n" - 返回值是
(int, error)，务必检查error—— 常见错误如磁盘满、文件权限不足、网络连接中断，此时n可能小于字符串长度
为什么有时写入失败却没报错？
典型场景：往 bytes.Buffer 写没问题，但换成 os.File 后看似成功、实际内容没落盘。这是因为 io.WriteString 只调用底层 Write，而文件写入可能还卡在 OS 缓冲区里。如果后续没调用 file.Close() 或 file.Sync()，进程退出时数据可能丢失。
- 对临时文件或日志，建议写完立即
Close()（用defer包裹最稳妥） - 若需多次写入又不想频繁开闭文件，改用
bufio.NewWriter并在最后调用Flush() -
io.WriteString本身不处理编码，输入字符串必须是 UTF-8 编码的string；若源数据是 GBK 字节，得先转码再写，否则会乱码
和 fmt.Fprint / fmt.Fprintf 比有什么区别？
核心差异在类型安全和开销：io.WriteString 是纯字节拷贝，不做任何格式解析，所以比 fmt.Fprintf(w, "%s", s) 快且确定；但它不能拼接变量、不支持格式动词（如 %d、%v）。
- 只写一个固定字符串？选
io.WriteString，零分配（Go 1.20+ 对小字符串已优化） - 要写
"user: " + name + ", age: " + strconv.Itoa(age)？不如直接用fmt.Fprintf，可读性高，且现代 Go 的fmt性能已接近手拼 - 误把
fmt.Fprint当io.WriteString用（比如传nil的io.Writer），前者可能 panic，后者返回明确的nilerror 和0字节数
一个容易被忽略的细节：写入空字符串
io.WriteString(w, "") 是合法调用，返回 (0, nil)。这在某些逻辑分支里容易被当成“没做任何事”，但其实它仍会触发一次 w.Write([]byte{}) 调用。对某些特殊 io.Writer（比如封装了超时控制的自定义 writer），空写也可能引发副作用。
立即学习“go语言免费学习笔记（深入）”；
- 日志中间件里判断是否写入空行时，别只看
err == nil，还得检查n == 0 - 测试中模拟写入行为时，如果 mock 的
Write方法没处理空切片，可能导致 panic - 在 HTTP handler 中向
http.ResponseWriter写空字符串虽不报错，但可能干扰 header 发送时机，尤其搭配http.Flusher时
