http.FileServer 是 Go 内置的轻量静态文件服务方案，需正确配置 http.Dir 根目录与 http.StripPrefix 前缀对齐，配合 spaHandler 支持根路径跳转 index.html，并推荐使用 os.DirFS 提升安全性，生产环境还需处理缓存、路径规范与路由优先级。
用 http.FileServer 快速启动静态文件服务
Go 自带的 http.FileServer 是最轻量、最直接的方式，无需额外依赖。它本质是一个 http.Handler，把本地目录映射为 HTTP 路径。
常见错误是路径没对齐：比如当前工作目录不是资源根目录，或没处理 URL 路径前缀导致 404。必须确保 http.Dir 指向的是你期望被访问的**物理根目录**，且 http.StripPrefix 的前缀和路由注册路径严格一致。
示例：
package main
import (
"net/http"
"log"
)
func main() {
fs := http.FileServer(http.Dir("./static")) // ./static 是你的 HTML/CSS/JS 所在目录
http.Handle("/static/", http.StripPrefix("/static/", fs))
log.Println("Serving at :8080")
log.Fatal(http.ListenAndServe(":8080", nil))
}
-
./static必须存在，且包含index.html等资源 - 访问
http://localhost:8080/static/style.css才能命中，/static/这个前缀不能少 - 如果去掉
http.StripPrefix，请求路径会带着/static/去查文件系统，结果就是找./static/static/style.css—— 肯定失败
处理根路径（/）自动跳转到 index.html
http.FileServer 默认不支持将 / 映射到 index.html，访问根路径会返回 404 或目录列表（取决于是否启用 http.Dir 的索引功能）。要实现 SPA 风格的前端路由或常规首页展示，得自己兜底。
立即学习“go语言免费学习笔记（深入）”；
做法是写一个中间 handler，优先尝试返回 index.html，再交给 FileServer 处理其他请求：
func spaHandler(root http.Handler, indexPath string) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if r.URL.Path == "/" || r.URL.Path == "/index.html" {
http.ServeFile(w, r, indexPath)
return
}
root.ServeHTTP(w, r)
})
}
// 使用：
fs := http.FileServer(http.Dir("./static"))
http.Handle("/", spaHandler(fs, "./static/index.html"))
-
http.ServeFile直接读取并响应单个文件，比FileServer更可控 - 注意
indexPath是绝对或相对路径，必须可读；若用相对路径，以当前工作目录为基准 - 这个逻辑只覆盖
/和/index.html，其余路径仍由FileServer处理，不影响 CSS/JS 加载
避免暴露敏感路径：禁用目录遍历与隐藏文件
http.Dir 默认允许目录遍历（如 ..），也默认返回隐藏文件（以 . 开头），这在生产环境是风险点。
Go 1.16+ 提供了 http.FS 接口和 os.DirFS，天然拒绝 ..，且默认不列出隐藏文件 —— 更安全、更现代：
fs := http.FileServer(http.FS(os.DirFS("./static")))
http.Handle("/static/", http.StripPrefix("/static/", fs))
-
os.DirFS返回的是fs.FS，不是原始http.Dir，路径解析由标准库严格控制 - 即使请求
/static/../config.yaml，也会被拒绝（返回 400） - 但注意：
os.DirFS不支持http.Dir的“自动索引”行为（即列出目录内容），若需要该功能，得另写 handler
生产环境要注意的几个实际问题
本地跑通不等于生产可用。几个容易忽略但影响真实的点：
- 静态资源路径应尽量使用相对路径或带版本号的 URL（如
/static/v1.2.0/app.js），避免浏览器缓存旧文件 -
http.FileServer不设置Cache-Control响应头，默认不缓存，可通过包装 handler 添加头信息 - 大文件下载时，
FileServer内部用io.Copy流式传输，内存占用低，但若需断点续传、限速或鉴权，就得自己实现http.Handler - Windows 下路径分隔符（
\）可能引发问题，统一用filepath.Join构造路径，别手拼
真正难的不是启动服务，而是让每个请求都按预期路径、权限、缓存策略和错误码返回 —— 尤其当静态资源混着 API 一起部署时，路由优先级和路径截断很容易出错。
