http.ServeFile是最简静态文件下载方案，但需手动设Content-Disposition强制下载、用filepath.Clean防遍历漏洞；生产环境推荐自定义Handler实现权限校验、Range支持与精准缓存控制。
如何用 http.ServeFile 快速提供静态文件下载
直接暴露文件路径给客户端下载，http.ServeFile 是最简方案，但仅适用于固定路径、无需权限控制的场景。它会自动设置 Content-Type 和 Last-Modified，但不会设置 Content-Disposition，浏览器可能选择内嵌而非下载。
- 必须确保传入的
filepath是绝对路径，相对路径易导致 404 或目录遍历漏洞 - 若希望强制下载，需手动写响应头：
w.Header().Set("Content-Disposition", "attachment; filename=\"myfile.zip\"") -
http.ServeFile不校验文件是否存在，不存在时返回 404；但若路径含..且未清理，可能被用于读取任意文件（如/etc/passwd） - 不建议在生产环境直接使用，尤其当文件名来自 URL 参数时——必须用
filepath.Clean并校验前缀
如何手动构造 HTTP 响应实现可控下载
绕过 http.ServeFile 的限制，自己读取文件、写入响应体，能精确控制缓存策略、分块传输、权限校验和断点续传支持。
- 先用
os.Open打开文件，再调用stat, err := f.Stat()获取大小和修改时间 - 设置关键响应头：
w.Header().Set("Content-Length", strconv.FormatInt(stat.Size(), 10)) w.Header().Set("Last-Modified", stat.ModTime().UTC().Format(http.TimeFormat)) w.Header().Set("Content-Disposition", "attachment; filename=\""+filename+"\"") - 使用
io.Copy流式写入，避免全量加载大文件到内存：io.Copy(w, f)
- 若需支持
Range请求（如断点续传），不能直接用io.Copy，得解析Range头、用f.ReadAt跳读，并返回206 Partial Content
如何正确设置缓存头避免重复下载与陈旧内容
缓存行为由客户端决定，服务端只能通过响应头引导。对下载类资源，通常倾向「强缓存 + 校验」组合，而非完全禁用缓存。
- 静态资源（如版本化包：
v1.2.0/app-linux-amd64）适合用Cache-Control: public, immutable, max-age=31536000 - 动态生成或内容常变的文件（如用户导出报表），应设
Cache-Control: no-store或no-cache，并配合ETag校验 - 若用
ETag，推荐基于文件内容哈希（如sha256.Sum256）而非修改时间，避免内容未变但时间戳更新导致误判 - 注意：
Expires已被现代实践弱化，优先用Cache-Control；两者共存时以Cache-Control为准
为什么 http.FileServer 不适合直接用于下载路由
http.FileServer 是为静态站点服务设计的，其默认行为与下载需求存在本质冲突：它把路径映射为本地目录结构，并允许目录列表、忽略 Content-Disposition、不校验请求方法（如接受 POST 到文件路径）。
立即学习“go语言免费学习笔记（深入）”；
- 默认开启目录遍历（
http.Dir不过滤..），除非显式包装为安全封装器 - 无法统一拦截所有下载请求做鉴权（比如只允许登录用户下载某类文件）
- 不支持按 MIME 类型重写
Content-Type，某些二进制文件可能被识别为text/plain导致浏览器乱码渲染 - 若需日志记录下载行为、统计带宽、限速，必须绕过
FileServer自行实现 Handler
ETag，若没处理 If-None-Match 请求头并返回 304 Not Modified，客户端仍会重复下载整个文件。这个分支必须显式编码，Go 的标准库不会自动帮你做。 
