本文详解 go 中使用 `http.fileserver` 托管 css 等静态资源时的路径配置错误及修复方法，重点解决因目录路径不匹配导致浏览器无法加载 `/css/main.css` 的常见问题。
在 Go 的标准 HTTP 服务中，静态资源（如 CSS、JS、图片）需通过 http.FileServer 显式注册。你当前的代码存在一个关键路径错误：虽然 HTML 中引用的是 ，但服务器端却用 http.Dir("css") 去查找文件——而该路径是相对于当前工作目录（即运行 go run myApp.go 的目录），而非项目结构中的 static/css/。
根据你提供的目录结构：
webapp/
myApp/
server.go ← 当前源码所在位置
static/
index.html
css/
main.css ← 实际 CSS 文件位置当 server.go 在 myApp/ 目录下执行时，http.Dir("css") 会尝试读取 myApp/css/，但真实 CSS 文件位于上层 static/css/，因此请求 /css/main.css 返回 404。
✅ 正确做法是：确保 http.Dir() 指向物理文件所在的绝对或相对路径，并与 URL 路径前缀逻辑一致。
立即学习“前端免费学习笔记（深入）”；
修改 rootHandler 中的静态路由注册部分如下：
func rootHandler(w http.ResponseWriter, r *http.Request) {
// ✅ 正确：将 /css/ 请求映射到 static/css/ 目录
http.Handle("/css/", http.StripPrefix("/css/", http.FileServer(http.Dir("static/css"))))
if r.URL.Path != "/" {
errorHandler(w, r, http.StatusNotFound, "")
return
}
page := template.Must(template.ParseFiles(
"static/_base.html",
"static/index.html",
))
if err := page.Execute(w, nil); err != nil {
errorHandler(w, r, http.StatusInternalServerError, err.Error())
return
}
}⚠️ 注意事项：
- http.Handle() 必须在 page.Execute() 之前调用，否则路由未注册，CSS 请求将被后续逻辑忽略（Go 的 http.ServeMux 是顺序匹配，且 rootHandler 是兜底处理器）；
- http.StripPrefix("/css/", ...) 的作用是移除 URL 前缀 /css/，使 http.FileServer 能正确定位 main.css（即访问 /css/main.css → 内部查找 static/css/main.css）；
- 若项目部署时工作目录变化，建议使用绝对路径或 filepath.Join() 构建稳健路径（例如：http.Dir(filepath.Join("static", "css"))）；
- 推荐将静态资源路由统一提前注册（如 init() 中），避免每次处理请求都重复调用 http.Handle()（当前写法虽可运行，但属反模式）。
总结：Go 的 http.FileServer 不自动解析项目逻辑结构，它只忠实地按给定路径读取文件。务必让 http.Dir() 的参数与实际文件系统路径严格对应，并与 URL 路由前缀协同设计——这是解决静态资源 404 的核心原则。
