直接用http.FileServer会404、慢且不安全，因默认不补尾斜杠、不查index.html、路径非绝对、无缓存与gzip、无fallback；须用os.DirFS+StripPrefix（带/）加固，并自定义Handler实现fallback、缓存、压缩三层包装。
直接用 http.FileServer 启动静态服务，不加处理大概率会 404、慢、甚至被路径遍历攻击——它不是开箱即用的“高性能”方案，而是需要你亲手补上缓存、压缩、路径防护和 fallback 这四块。
为什么 http.FileServer 默认行为会出问题
它只做最基础的文件读取和响应，其他全靠你自己兜底：
- 访问
/assets（无尾部/）时，如果assets是目录，直接返回 404；必须显式请求/assets/才能进目录 - 不会自动查找
index.html：访问/或/docs/就是 404，除非你手动注册路由或改写 handler - 传
http.Dir("./static")是危险操作：工作目录一变，路径就错，首次请求就 404 - 不设
Cache-Control：浏览器每次重刷都拉一遍 JS/CSS，浪费带宽也拖慢首屏 - 不启用 gzip：文本类资源（HTML/JS/CSS）未压缩传输，体积常翻倍
必须用 os.DirFS + http.StripPrefix 构造安全路径
Go 1.16+ 推荐用 os.DirFS 替代 http.Dir，它默认拒绝 ../ 和 URL 编码绕过（如 %2e%2e%2fetc%2fpasswd），更安全。
http.StripPrefix 的前缀必须以 / 结尾，且顺序不能反：
立即学习“go语言免费学习笔记（深入）”；
-
"/static/"✅ —— 正确匹配并剥离 -
"/static"❌ —— 会错误匹配/static123，导致路径错乱 - 必须先
StripPrefix，再交给FileServer；反过来调用ServeHTTP会绕过内置路径校验
示例写法：
dir, _ := filepath.Abs("./public")
fs := http.FileServer(http.FS(os.DirFS(dir)))
http.Handle("/static/", http.StripPrefix("/static/", fs))
SPA 应用必须自己实现 fallback 到 index.html
http.FileServer 完全不做 fallback。React/Vue 的 History 模式刷新 /user/123 时，后端必须返回 index.html，否则就是 404。
正确做法是自定义 http.Handler，先检查路径是否对应真实文件，不存在且无扩展名时，才返回 index.html：
- 用
os.Stat检查文件是否存在，避免硬编码路径拼接 - 只对无扩展名路径（如
/admin、/）fallback，保留/logo.png这类资源直通 - 用
http.ServeFile返回index.html，它会自动校验路径、拒绝目录遍历
别用 c.String() 或重定向替代——前者不支持相对引用，后者暴露真实路径结构。
生产环境必须加的三层包装
原生 http.FileServer 是裸 handler，要变成“高性能”，得自己套三层：
-
缓存头中间件：对
.js、.css、.woff2设Cache-Control: public, max-age=31536000；HTML 设no-cache或must-revalidate -
gzip 压缩：用
gzip.Handler包整个 handler，但注意别和 Nginx 等前置代理 double-compress -
路径防护强化：即使用了
os.DirFS，仍建议在 fallback 逻辑中显式调用filepath.Clean并检查是否仍在允许根目录内
最容易被忽略的是 fallback 路径的 MIME 类型：直接 os.ReadFile 返回 HTML 内容会丢失 Content-Type，必须用 http.ServeFile 或手动设置 header。
