Gin中流式传输需手动设置响应头并边读边写响应体：小文件可用c.File，大文件必须用io.Copy+os.Open或c.DataFromReader，且头必须在首次Write前设全；未知长度时禁用Content-Length，启用chunked编码；断点续传需解析Range头并返回206状态。
流式传输响应在 Gin 中不是靠 c.Stream() 或 c.SSE() 自动完成的——它本质是控制底层 http.ResponseWriter 的写入时机和方式，关键在于「头必须提前设好，body 必须边读边写」。
Content-Length 不能设时，必须用 chunked 编码
当你不知道响应体总长度（比如从数据库游标读、调用远程流式 API、或生成动态 CSV），就不能设 Content-Length。此时 HTTP/1.1 会自动启用 Transfer-Encoding: chunked，但前提是：你不能提前写死长度，也不能调 c.Data() 或 c.String() 这类一次性写完的方法。
- 错误做法：
c.Header("Content-Length", "1024")+c.String(200, "data")→ 如果实际数据不是 1024 字节，客户端会卡住或报错 - 正确做法：不设
Content-Length，用c.Writer分块写，Gin 会自动加chunked头 - 注意：
c.Writer是http.ResponseWriter，调Write()前不能再调c.Header()，否则无效
用 c.Stream() 实现 SSE 或自定义流，但别漏掉头
c.Stream() 是 Gin 提供的流式回调接口，常用于服务端事件（SSE）或逐行返回日志，但它本身不帮你设任何响应头。浏览器是否识别为流，全看头是否合规。
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
- 必须手动设：
c.Header("Content-Type", "text/event-stream")（SSE）或"application/json"（逐条 JSON） - 必须设：
c.Header("Cache-Control", "no-cache")和c.Header("Connection", "keep-alive")，否则 Nginx 或浏览器可能缓存或断连 - 别在回调里调
c.Abort()或c.JSON()—— 流已开始，这些会 panic 或静默失败 - 示例片段：
func(c *gin.Context) { c.Header("Content-Type", "text/event-stream") c.Header("Cache-Control", "no-cache") c.Header("Connection", "keep-alive") c.Stream(func(w io.Writer) bool { fmt.Fprint(w, "data: hello\n\n") time.Sleep(1 * time.Second) return true // 继续 }) }
大文件下载必须用 DataFromReader，且头顺序不能错
用 c.File() 下载大文件会把整个文件读进内存；用 c.DataFromReader() 才是真流式。但它要求所有响应头在第一次 Write 前就设置完毕，否则头被忽略，浏览器可能直接渲染而非下载。
立即学习“前端免费学习笔记（深入）”；
- 关键头至少包括：
Content-Type、Content-Disposition、Content-Length（如果已知）、Cache-Control: no-cache - 顺序铁律：
c.Header()全部调完 → 才能调c.DataFromReader()，中间插任何c.String()或c.JSON()都会破坏流 - 文件名含中文？用
filename*=UTF-8''...格式，别只用filename="..."，否则 Chrome/Firefox 可能乱码 - 示例：
f, _ := os.Open("./big.zip") defer f.Close() c.Header("Content-Type", "application/zip") c.Header("Content-Disposition", `attachment; filename*=UTF-8''%E5%A4%A7%E6%96%87%E4%BB%B6.zip`) c.Header("Cache-Control", "no-cache") c.DataFromReader(200, f.Size(), "application/zip", f, nil)
最容易被忽略的是头和 body 的时序耦合——不是“写了头就行”，而是“头写完、还没动 Writer 之前，才能开始流”。很多问题表面是前端没下载，实际是后端头写晚了半拍，HTTP 已经进入 body 阶段，再设头等于白设。
