http.FileServer 是最轻量的静态文件服务器，需配合 http.StripPrefix 和 http.Dir 限定根目录以防越界访问；http.Dir 路径不能带尾斜杠，否则可能因 filepath.Clean 导致安全风险；默认支持 index.html（请求路径须以 / 结尾），但不启用目录列表，生产环境应禁用。
用 http.FileServer 启动一个可访问目录的服务器
Go 标准库的 http.FileServer 是最轻量、最直接的方式，不需要额外依赖。它本质是一个 http.Handler，接收请求路径后，按相对路径映射到本地文件系统。
常见错误是直接传入原始路径导致越界访问（比如请求 ../../etc/passwd），所以必须用 http.StripPrefix 配合 http.Dir 显式限定根目录：
package main
import (
"net/http"
)
func main() {
fs := http.FileServer(http.Dir("./public"))
http.Handle("/static/", http.StripPrefix("/static/", fs))
http.ListenAndServe(":8080", nil)
}
这样访问 http://localhost:8080/static/logo.png 会读取 ./public/logo.png；而 /static/.. 类路径会被 http.Dir 自动拒绝——这是它内置的安全机制，不是靠 StripPrefix 实现的。
为什么 http.Dir 的路径不能带尾部斜杠
http.Dir 构造函数接收的是一个字符串路径，它内部会调用 filepath.Clean 处理。如果传入 "./public/"（带尾斜杠），Clean 会将其规范化为 "./public"，看起来没区别；但若传入 "/tmp//" 或 "./public/."，就可能意外暴露父目录。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 始终用不带尾斜杠的路径：写
http.Dir("./public")，别写http.Dir("./public/") - 路径必须是相对或绝对的合法路径，不能是空字符串或
"."（这会让FileServer尝试服务整个当前目录，极危险） - Windows 下注意路径分隔符：
http.Dir内部用filepath处理，所以用"/"或"\"都行，但统一用"/"更可移植
如何支持目录列表和默认页（如 index.html）
http.FileServer 默认不渲染目录列表，也不自动查找 index.html。要启用这两项，得自己包装 handler：
启用目录列表需实现 http.FileSystem 接口并覆盖 Open 方法，但更简单的是用 http.ServeFile + 自定义逻辑；不过标准做法是：只要目录下有 index.html，FileServer 就会自动返回它——前提是请求路径以 / 结尾（如 /static/），否则它只做文件匹配。
- 确保请求 URL 末尾有
/才能触发默认页查找：访问/static/→ 查./public/index.html；访问/static（无斜杠）→ 返回 404 - 目录列表需要额外处理：Go 1.16+ 可用
fs.Sub+http.FS，但对老版本，建议用第三方小包如github.com/elazarl/go-bindata-assetfs或干脆不开启——暴露目录结构本身就有安全风险 - 生产环境务必禁用目录列表：没有理由让外部看到你有哪些文件
静态资源路径被代理或 CDN 覆盖时怎么调试
当 Nginx 或 Cloudflare 在 Go 服务前加了一层，常出现 404 或 MIME 类型错误。根本原因是路径重写没对齐，或响应头缺失。
- 检查
Content-Type：Go 的FileServer依赖http.DetectContentType和扩展名映射表（mime.TypeByExtension），若文件扩展名不标准（如.mjs），需手动注册：mime.AddExtensionType(".mjs", "application/javascript") - 代理转发时保留原始路径：Nginx 中不要用
rewrite破坏路径层级，优先用proxy_pass http://localhost:8080/;（注意末尾/） - 调试技巧：curl 加
-v看响应头，确认Content-Length、Content-Type和状态码是否合理；再对比直接访问 Go 服务和经过代理的响应差异
真正麻烦的从来不是启动服务器，而是路径语义在多层中间件之间是否一致——StripPrefix 去了什么、反向代理加了什么、浏览器请求里写了什么，三者必须咬合。漏掉任意一环，404 就悄无声息地来了。
