答案：通过设置 Cache-Control、ETag 等响应头控制 浏览器 缓存，并结合文件哈希生成唯一 URL，可高效实现golang 静态文件缓存。
在 golang 中实现静态文件缓存，核心是利用 http 响应头控制 浏览器 缓存行为，并结合文件指纹或版本化 URL 提升缓存效率。下面介绍几种实用方式。
使用 HTTP 缓存头控制浏览器行为
通过设置 Cache-Control、ETag 和Last-Modified等响应头，可以让浏览器缓存静态资源，减少重复请求。
Go 的 http.FileServer 默认不开启强缓存，但可以包装处理函数来自定义头部：
func cacheMiddleware(h http.Handler) http.Handler {return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {// 对静态资源设置缓存策略 if strings.HasPrefix(r.URL.Path, "/Static/") {w.Header().Set("Cache-Control", "public, max-age=31536000, immutable") // 缓存一年 } h.ServeHTTP(w, r) }) } // 使用 fs := http.FileServer(http.Dir("static/")) http.Handle("/static/", cacheMiddleware(fs))
说明 ：上面代码对/static/ 路径下的文件设置一年缓存时间，并标记为不可变（immutable），适合带哈希指纹的资源。
立即学习“go 语言免费学习笔记（深入）”；
使用文件内容哈希生成唯一 URL
为了让浏览器在文件更新后强制刷新缓存，推荐在文件名中加入内容哈希，例如app.a1b2c3d4.js。
实现思路：
这样每次文件内容变化，URL 也随之变化，浏览器会重新下载，而未变的资源继续使用本地缓存。
结合 http.ServeFile 手动控制缓存
对于动态决定是否返回缓存的场景，可使用 http.ServeFile 并配合条件请求处理。
http.HandleFunc("/assets/", func(w http.ResponseWriter, r *http.Request) {filePath := "./" + r.URL.Path file, err := os.Open(filePath) if err != nil {http.NotFound(w, r) return } defer file.Close() info, _ := file.Stat() w.Header().Set("Cache-Control", "public, max-age=604800") // 缓存一周 // 启用 ETag 和条件请求支持 etag := fmt.Sprintf("%x-%x", info.ModTime().unix(), info.Size()) w.Header().Set("ETag", etag) if match := r.Header.Get("If-None-Match"); match != "" {if match == etag { w.WriteHeader(http.StatusNotModified) return } } http.ServeContent(w, r, filePath, info.ModTime(), file) })
说明 ：http.ServeContent 会自动处理 If-None-Match 和If-Modified-Since，返回 304状态码 节省带宽。
部署时配合反向代理缓存
在生产环境中，建议结合 nginx 等反向代理做静态文件缓存：
- Nginx 设置
expires指令缓存静态资源 - Go 服务只负责动态逻辑，静态文件交由 Nginx 处理
- 减轻 Go 应用负载，提升响应速度
示例 Nginx 配置：
location /static/ {alias /path/to/static/; expires 1y; add_header Cache-Control "public, immutable";}
基本上就这些。关键是根据资源是否变动选择合适的缓存策略，配合哈希指纹和 HTTP 头，就能高效利用客户端缓存。不复杂但容易忽略细节。
