最简静态服务应使用 http.FileServer(os.DirFS("static")) 配合 http.StripPrefix 处理前缀，避免路径遍历与404；http.ServeFile 仅适用于单文件场景，不支持目录索引、缓存、gzip及大文件流式传输；SPA fallback 需先检查文件存在性再回退至 index.html；embed.FS 必须用 http.FS 转换且路径为编译期字面量。
用 http.FileServer 启动最简静态服务
Go 原生支持静态文件服务，不需要额外包。核心就是 http.FileServer 配合 http.Handle 或 http.HandleFunc，但直接传入 os.DirFS（Go 1.16+）比老式 http.Dir 更安全、更符合现代路径处理逻辑。
常见错误是把相对路径写死，比如 http.FileServer(http.Dir("static"))，结果在不同工作目录下启动就 404；或者没处理 URL 路径前缀，导致 /assets/logo.png 请求被转发到根目录找 assets/logo.png 而不是 static/assets/logo.png。
- 用
os.DirFS("static")替代http.Dir("static")，避免路径遍历风险（../会被自动拒绝） - 必须加一层路由前缀，例如
http.Handle("/static/", http.StripPrefix("/static/", http.FileServer(os.DirFS("static")))) - 如果静态文件放在项目外（如
/var/www），确保 Go 进程有读取权限，Linux 下常因 SELinux 或用户权限失败，错误不报具体路径，只返回 404 或 500
为什么 http.ServeFile 不适合做完整静态服务
http.ServeFile 只响应单个文件，不能列目录、不支持 MIME 类型自动推断（比如 .webp 返回 text/plain）、也不处理 index.html 回退。它只该用在「明确知道要返回哪个文件」的场景，比如下载接口或调试时临时吐一个 HTML。
典型误用：用 http.HandleFunc("/app.js", func(w http.ResponseWriter, r *http.Request) { http.ServeFile(w, r, "dist/app.js") }) —— 看似能用，但一旦文件不存在就 panic，且无法统一设置缓存头、不支持 gzip、不兼容 HTTP/2 的服务器推送。
立即学习“go语言免费学习笔记（深入）”；
-
http.ServeFile会尝试打开文件并读取全部内容进内存，大文件（>10MB）易触发 OOM - 它不检查
If-Modified-Since，每次请求都重发整个文件，浪费带宽 - 没有内置目录索引，
/请求直接 404，没法当 SPA 的 fallback 页面用
SPA 路由 fallback 怎么配才不炸
Vue/React 项目打包后是单页应用，前端路由靠 JS 处理，但刷新 /user/123 时，后端必须把所有非 API 请求都 fallback 到 index.html，否则 Nginx 没配好就会返回 404。
Go 里没有开箱即用的 fallback 中间件，得自己判断路径是否命中真实文件，再决定是否透传给 FileServer 或返回 index.html。关键点在于：先查文件是否存在，再决定走哪条路，顺序反了就永远 fallback。
- 用
fs.Stat检查os.DirFS("dist").Open(path)是否成功，别用os.Stat查本地路径——因为os.DirFS可能挂载的是 zip 或嵌入的embed.FS - 对
/api/、/healthz这类已知 API 前缀，必须提前拦截，否则会被 fallback 到 HTML 导致接口失效 - 注意 URL 解码：浏览器发来的
%20在r.URL.Path里已是空格，但文件系统不接受空格名，需提前替换或拒绝
嵌入静态资源用 embed.FS 时要注意什么
Go 1.16 引入 embed，能把静态文件编译进二进制，省去部署时同步文件的麻烦。但 embed.FS 是只读的，且路径必须是字面量字符串（不能拼接变量），编译期就锁定，运行时无法热更。
最容易踩的坑是路径写错：比如 //go:embed dist/* 写成 //go:embed dist/**，后者不合法；或者 embed.FS 初始化后直接传给 http.FileServer 却忘了用 http.FS 包一层转换。
-
embed.FS的路径是相对于//go:embed注释所在文件的目录，不是项目根目录 - 必须用
http.FileServer(http.FS(myEmbedFS))，漏掉http.FS会编译失败：类型不匹配 - 嵌入的文件不支持修改时间戳，所以
Last-Modified头永远是 Unix 零值，CDN 或浏览器可能缓存策略异常
复杂点在于混合模式：有些资源想嵌入（如 HTML/CSS），有些想外置（如用户上传的图片），这时得写两个 handler 分流，而且要小心路径冲突——比如都注册了 /images/，后注册的会覆盖前一个。
