必须检查 writer.write 错误，因磁盘满、连接断开等会导致静默丢失数据；仅 bytes.buffer（go 1.20+）和 strings.builder 可安全忽略，其余均需显式处理或注释说明。
为什么不能直接忽略 Writer.Write 的错误返回值
Go 的 io.Writer 接口要求所有实现必须返回 error，这不是装饰——底层可能正在写磁盘、发网络包、刷缓冲区。跳过检查等于默认“这次写肯定成功”，而实际可能是磁盘满、连接断开、管道被关，后续数据静默丢失，日志没报错，问题难复现。
常见错误现象：fmt.Fprintf(w, "hello") 看似执行了，但 w 是 http.ResponseWriter 时若客户端提前断连，写入会失败，却没做任何处理，响应体不完整也不报错。
- HTTP handler 中直接调用
w.Write()不检查错误 → 响应截断无感知 - 向
os.File写日志时忽略错误 → 日志丢失且无 fallback - 在
bufio.Writer后忘了Flush()或忽略其错误 → 缓冲数据未落盘
Errcheck 工具怎么配置才真正起作用
Errcheck 默认只检查顶层函数调用的错误返回，对方法调用（如 w.Write()）默认不报，必须显式启用 -asserts 和 -blank 才能覆盖常见误用场景。
正确配置命令行：
errcheck -asserts -blank -ignore '^(os\.|net\.|syscall\.)' ./...
-asserts 检查接口方法调用（含 Write、Close 等）；-blank 要求所有错误必须被显式接收（哪怕赋给 _）；-ignore 是可选但推荐的，避免对系统级包中已知难处理的错误（如 os.Remove 的 ENOENT）过度告警。
- 不加
-asserts→w.Write()完全不会被扫描 - 不加
-blank→ 允许写成w.Write(b)（无接收），这正是你要防的 - 把
errcheck加进 CI 的make lint步骤，而不是只本地跑一次
哪些 Write 场景真可以忽略错误？怎么安全地忽略
极少场景下可忽略，但必须有明确理由和防御性设计，不能靠“应该不会出错”赌一把。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
典型可忽略场景只有：向内存缓冲（bytes.Buffer）写入，且确认容量足够、不会触发扩容失败（bytes.Buffer 的 Write 在 Go 1.20+ 后已保证永不返回非-nil error）。
-
bytes.Buffer.Write()可安全忽略（但需 Go ≥ 1.20；旧版本仍可能因 OOM 返回 error） -
strings.Builder.Write()同理，且更严格保证无 error - 其他所有情况——包括
bufio.Writer.Write()、gzip.Writer.Write()、http.ResponseWriter.Write()——都必须检查或显式丢弃（用_ = w.Write()） - 若决定忽略，必须加注释说明原因，例如：
// bytes.Buffer.Write never returns error (Go 1.20+)
HTTP handler 里写响应体的典型错误模式
很多人以为 http.ResponseWriter 的 Write 失败是小概率事件，其实客户端关闭连接、代理超时、移动端切网都会立刻触发 write: broken pipe 或 write: connection reset by peer。
错误写法：
func handler(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("ok")) // ← 这里错误被吞掉
}
正确做法是至少记录错误（尤其 debug 模式），或按业务需要降级：
- 用
if _, err := w.Write(b); err != nil { log.Printf("write failed: %v", err) } - 对关键响应，可提前
if !hijacked && !w.(http.Hijacker).Hijack() { ... }判断是否还能写（但通常没必要） - 不要在
defer w.Write()里忽略错误——defer 不捕获 panic，也不帮你处理 write 失败
最常被忽略的一点：即使你检查了 Write 错误，也得记得 Flush()（如果用了 bufio.NewWriter(w)）并检查它的错误——否则缓冲区卡住，客户端永远收不到数据。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
