本文详解 go 中静态资源（如 css）路径配置的关键原理，指出 `http.fileserver` 路径解析依赖当前工作目录，并提供可复用的健壮方案，避免因启动位置不同导致的 404 问题。
在 Go Web 开发中，http.FileServer 是托管静态文件（如 CSS、JS、图片）最常用的方式，但一个常见陷阱是：它使用的是相对路径，而该路径始终相对于程序的当前工作目录（working directory），而非源码文件所在目录。这意味着即使你的项目结构清晰，只要启动位置不对，CSS 就会 404。
以你提供的结构为例：
src/
├── css/
│ └── css490.css
├── server/
│ └── server.go
└── templates/
└── layout.html你写下了这行关键代码：
http.Handle("/css/", http.StripPrefix("/css/", http.FileServer(http.Dir("css"))))这里 http.Dir("css") 表示“在当前工作目录下查找名为 css 的子目录”。因此：
立即学习“前端免费学习笔记（深入）”；
-
✅ 正确启动方式（从 src/ 目录运行）：
cd src go run server/server.go
此时工作目录为 src/，http.Dir("css") 找到 src/css/，访问 http://localhost:8080/css/css490.css 成功。
-
❌ 错误启动方式（从 src/server/ 运行）：
cd src/server go run server.go
工作目录变为 src/server/，http.Dir("css") 尝试查找 src/server/css/ —— 不存在，返回 404。
❌ 构建后执行（如 go build -o ../bin/app && cd ../bin && ./app）： 工作目录为 bin/，而 css/ 不在 bin/ 下，同样 404。
✅ 推荐解决方案：使用绝对路径 + 嵌入式文件系统（Go 1.16+）
为彻底规避工作目录依赖，推荐使用 embed 包将静态资源编译进二进制文件，实现零配置、跨平台部署：
package main
import (
"embed"
"html/template"
"net/http"
)
//go:embed css/*
var cssFS embed.FS
//go:embed templates/*
var templateFS embed.FS
func main() {
// 安全托管 CSS：/css/ → css/ 目录下的所有文件
http.Handle("/css/", http.StripPrefix("/css/", http.FileServer(http.FS(cssFS))))
// 加载 HTML 模板（注意：模板中 href 应改为 /css/css490.css）
tmpl := template.Must(template.ParseFS(templateFS, "templates/*.html"))
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
tmpl.Execute(w, nil)
})
http.ListenAndServe(":8080", nil)
}同时，务必修正 HTML 中的链接路径：
❌ 错误（相对路径，易断裂）：
✅ 正确（绝对路径，与路由一致）：
⚠️ 注意事项总结
- http.Dir("xxx") 永远是相对于运行时工作目录，不是 .go 文件位置；
- 开发阶段可统一约定启动路径（如始终 cd src && go run ...），但生产环境不可靠；
- 使用 embed.FS 是 Go 1.16+ 最佳实践，无需额外文件拷贝，二进制自包含；
- 若需兼容旧版本 Go，可借助 os.Executable() + filepath.Dir() 动态计算二进制所在目录，再拼接 css/ 路径（但嵌入式方案更简洁可靠）。
通过以上调整，你的 CSS 将稳定加载，再无神秘 404。
