http.ServeFile 默认不加缓存头是设计选择，为避免开发时缓存导致文件更新不可见；需改用 http.FileServer + StripPrefix + 自定义 handler 注入 Cache-Control 等响应头。
为什么 http.ServeFile 默认不加缓存头
Go 标准库的 http.ServeFile 为了安全和兼容性，默认不设置任何 Cache-Control，也不写 ETag 或 Last-Modified。它只做最基础的文件读取和响应，连 Content-Length 都是靠底层自动计算的。这意味着每次请求静态资源（比如 /static/app.js），浏览器都会发完整 GET 请求，服务器返回 200 —— 完全没利用浏览器缓存。
- 这不是 bug，是设计选择：避免缓存导致开发者改了文件却看不到效果
- 但上线后必须手动干预，否则首屏加载慢、CDN 回源多、带宽浪费明显
- 别指望中间件自动补 —— Go 的
net/http中间件链里没有默认缓存策略层
用 http.FileServer + http.StripPrefix 加缓存头最稳妥
直接替换 http.ServeFile，改用 http.FileServer 实例，并包装一层 handler 来注入响应头。这是最轻量、无依赖、兼容所有 Go 版本的做法。
- 必须用
http.StripPrefix去掉 URL 前缀，否则文件路径会错（比如访问/static/main.css时，FileServer会尝试读./static/static/main.css） -
Cache-Control值要按资源类型区分：max-age=31536000（1 年）适合带哈希名的 JS/CSS；max-age=3600（1 小时）适合未哈希的 HTML 或图片 - 务必加
immutable（如Cache-Control: public, max-age=31536000, immutable），告诉浏览器“这个资源不会变”，避免在max-age内发条件请求
fs := http.FileServer(http.Dir("./dist"))
http.Handle("/static/", http.StripPrefix("/static/", fs))
// 然后包装缓存头
http.Handle("/static/", http.StripPrefix("/static/", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Cache-Control", "public, max-age=31536000, immutable")
fs.ServeHTTP(w, r)
})))
http.ServeFile 能不能硬塞缓存头
不能。因为 http.ServeFile 是函数调用，不是 handler 实例，你没法在它执行前或后可靠地操作 ResponseWriter 头 —— 它内部可能已经写了状态码和部分 header，再调用 w.Header().Set() 无效，甚至触发 http: superfluous response.WriteHeader call 错误。
- 常见翻车点：在
http.ServeFile调用前设 header，结果被忽略；调用后设，报错或静默失败 - 有人用
httptest.ResponseRecorder拦截再重写 —— 这是测试用法，生产环境不可行 - 结论：想控制缓存，就别用
http.ServeFile，换http.FileServer+ 自定义 handler
要不要加 ETag 或 Last-Modified
如果你用构建工具生成带内容哈希的文件名（比如 main.a1b2c3d4.js），就完全不需要 ETag 或 Last-Modified。这类资源天生 immutable，浏览器靠 URL 就能区分版本，条件请求（If-None-Match）纯属多余。
立即学习“go语言免费学习笔记（深入）”；
- 加了反而拖慢服务端：每次都要读文件算 hash 或 stat 取 mtime
- Go 标准库的
FileServer默认开ETag，但你可以关掉：http.FileServer不提供开关，得自己实现http.FileSystem接口来禁用 - 更简单的做法：确保构建输出带哈希，然后用
immutable+ 长max-age，彻底绕过验证逻辑
StripPrefix 少一个斜杠、静态目录路径写错、或者把缓存头加在了错误的 handler 分支上，都会导致缓存失效或 404。检查方式很简单：用 curl 看响应头，确认 Cache-Control 出现在真实资源响应里，而不是 404 页面上。 
