在go的net/http包中，响应头必须在调用writeheader()之前全部设置完毕；一旦writeheader()被调用（或隐式触发），响应头即刻写入并发送，后续对header()的修改将被忽略。
在go的net/http包中，响应头必须在调用writeheader()之前全部设置完毕；一旦writeheader()被调用（或隐式触发），响应头即刻写入并发送，后续对header()的修改将被忽略。
在Go Web开发中，http.ResponseWriter 的行为遵循一个关键原则：响应头与响应体的写入具有不可逆性与时序约束。WriteHeader(statusCode) 的作用不仅是设置HTTP状态码，更是显式触发响应头的序列化与发送——一旦执行，底层连接会立即将已构建的头部信息刷出到客户端。此时再调用 w.Header().Set() 或 w.Header().Add() 等方法，操作的是一个已被“冻结”的 Header 映射，不会影响已发出的响应。
因此，以下代码会导致 Content-Type 头失效：
w.WriteHeader(http.StatusCreated) // ❌ 响应头已发送
w.Header().Set("Content-Type", "application/json") // ⚠️ 此行无效
w.Write(js)而正确的顺序是：
w.Header().Set("Content-Type", "application/json") // ✅ 先设置所有头
w.Header().Set("X-Request-ID", reqID) // ✅ 可链式添加多个头
w.WriteHeader(http.StatusCreated) // ✅ 再发送状态码和头
w.Write(js) // ✅ 最后写入响应体⚠️ 注意事项：
立即学习“go语言免费学习笔记（深入）”；
- 即使未显式调用
WriteHeader()，只要调用w.Write()且尚未发送状态码，Go会自动补发200 OK并连同当前Header一并写出——这意味着此时Header也已锁定； -
w.Header()返回的是一个http.Header类型（即map[string][]string），其修改仅在Header未提交前生效； - 若需动态决策状态码或头信息，建议先完成全部逻辑判断与Header组装，最后统一调用
WriteHeader()。
✅ 最佳实践总结：
始终遵循 “Header → WriteHeader → Body” 三步顺序；将Header设置视为原子准备阶段，WriteHeader作为不可逆的发送指令，Body写入则是最终交付。这一设计虽需开发者显式管理时序，却保障了HTTP协议语义的严谨性与传输效率。
