用http.FileServer搭配http.StripPrefix即可开箱即用，核心是两行代码组合：FileServer负责读取文件，StripPrefix修正URL路径映射；常见404源于路径未对齐，如访问/static/js/app.js而文件在./public/js/app.js，须用StripPrefix("/static/", ...)剥离前缀再查找。
用 http.FileServer 搭配 http.StripPrefix 就能跑起来
不需要框架，Go 标准库开箱即用。核心就是两行代码组合：http.FileServer 负责读取文件，http.StripPrefix 修正 URL 路径映射关系。常见错误是路径没对齐导致 404——比如你访问 /static/js/app.js，但文件实际在磁盘的 ./public/js/app.js，这时必须用 StripPrefix("/static", ...) 把请求前缀去掉，再交给 FileServer 去 ./public 下找。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 静态资源目录（如
./public）必须存在且有读权限，否则启动不报错但请求全 500 -
http.FileServer默认禁用目录列表，如需开启要手动包装：用http.Dir(".").Open配合自定义http.ServeHTTP，但生产环境不建议打开 - 路径拼接别用字符串拼，用
filepath.Join处理跨平台差异，尤其 Windows 下反斜杠容易出问题
如何让 CSS/JS 的缓存可控，而不是全靠浏览器默认策略
浏览器对静态资源缓存太激进，改了文件用户可能看不到更新。Go 不提供内置缓存头配置，得自己 wrap http.Handler 注入 Cache-Control。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 区分资源类型设置不同策略：HTML 页面设
Cache-Control: no-cache，JS/CSS 加哈希后缀的可设max-age=31536000（1年），图片按需设 1 小时或 1 天 - 别直接修改
http.FileServer返回的 handler 的Header()，它每次请求都新建响应对象；要用中间件方式，在ServeHTTP中统一写头 - 注意 ETag 和 Last-Modified 不会自动生效，
http.FileServer只在文件系统支持时返回Last-Modified，ETag 需自己计算并写入响应头
遇到 http: proxy.URL returns invalid URL 或 CORS 跨域失败怎么办
这不是静态服务本身的问题，而是部署场景带来的副作用。比如前端跑在 localhost:3000，Go 后端在 :8080，AJAX 请求静态资源时触发 CORS；或者你在 Nginx 后面反向代理，但没配好 X-Forwarded-* 头，导致 http.Request.URL 构造错误。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- CORS 问题最简解法：加一层中间件，对所有
/static/*请求写入Access-Control-Allow-Origin: *（开发用），生产环境请精确控制来源 - 代理场景下，务必用
http.ProxyFromEnvironment或自定义http.Transport，避免直接调proxy.URL；更常见的是反向代理配置漏了proxy_set_header Host $host;，导致 Go 里r.Host为空 - 如果用了
http.Redirect或生成绝对 URL，一定要检查r.URL.Scheme和r.Header.Get("X-Forwarded-Proto")，否则 HTTPS 站点返回 HTTP 链接
为什么加了 gzip 压缩反而让小文件变慢
标准库的 gzip.Handler 对所有响应做压缩，但小于 1KB 的 JS/CSS 文件压缩后体积不变甚至更大，CPU 白花不说，还增加延迟。这不是 bug，是算法特性。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 不要全局套
gzip.Hander，而是在中间件里判断Content-Type和响应体长度，只对text/css、application/javascript、text/html且 >1KB 的响应压缩 - 压缩级别别用
gzip.BestCompression，选gzip.DefaultCompression平衡速度和率；调试时可临时设gzip.NoCompression排查 - 注意：
http.FileServer返回的响应没有Content-Length头（因为底层用io.Copy流式传输），gzip 中间件无法预估压缩后大小，可能触发 chunked 编码，某些老旧客户端处理不好
真正麻烦的不是怎么写，而是怎么让路径、缓存、代理、压缩四者互不干扰。每个环节单独测都正常，串一起就丢请求或缓存错乱——建议用 curl -I 逐层看响应头，比日志更直接。
