http.fileserver上线即404的根本原因是http.dir("static")依赖当前工作目录，而本地开发与生产环境的os.getwd()不同；必须用filepath.abs("./static")转绝对路径或改用更安全的os.dirfs。
Go 标准库的 http.FileServer 足够用，但直接写 http.Dir("static") 很大概率在部署后 404——根本原因不是代码错，而是路径没对齐。
为什么 http.FileServer 一上线就 404
常见错误是把相对路径当绝对路径用：http.Dir("static") 的行为依赖当前工作目录（os.Getwd()），而你本地 go run main.go 和生产环境用 systemd 启动时 pwd 往往不同。
- 必须用
filepath.Abs("./static")显式转成绝对路径，再传给http.Dir - 如果静态文件放在项目外（如
/var/www/html），确保 Go 进程有读权限；Linux 下 SELinux 或用户组限制常导致静默失败，只返回 404 或 500，不报具体路径错误 -
os.DirFS("static")（Go 1.16+）比http.Dir更安全：自动拒绝../路径遍历，且不依赖os.Stat的 cwd 行为
怎么配 /static/ 前缀才不炸
/static/ 是路由前缀，不是语法关键字。它要同时满足三件事：HTML 中的引用、HTTP 路由注册、本地文件路径，三者必须严格对齐。
- HTML 中引用必须以
/static/开头，比如<link href="/static/css/app.css">；写成css/app.css或./static/css/app.css都会失效 -
http.Handle("/static/", ...)的第一个参数必须和 HTML 中的前缀完全一致（结尾斜杠不能少） -
http.StripPrefix("/static/", ...)的第一个参数也必须和上面一样，否则剩余路径拼到文件系统时多了一层或少了一层 - 最终
http.Dir或os.DirFS指向的，是 Strip 后请求路径所对应的磁盘根目录，比如请求/static/js/main.js→ Strip 后是js/main.js→ 就得去./static/js/main.js找
SPA fallback 怎么写才不卡死
Vue/React 打包后刷新 /user/123 报 404，是因为 http.FileServer 不知道该返回 index.html。没有开箱即用的中间件，得自己判断文件是否存在。
- 别用
http.ServeFile(w, r, "index.html")直接 fallback——它不检查路径合法性，可能被绕过安全过滤 - 正确做法：先用
fs.Open()尝试打开请求路径对应文件；不存在时，再用http.ServeFile返回index.html（注意路径必须是编译期字面量，不能拼接） - 如果用了
embed.FS，必须用http.FS(embedFS)包一层才能传给http.FileServer；且//go:embed的路径必须是字符串字面量，不能是变量 - 大文件（>10MB）慎用
http.ServeFile：它会一次性读进内存，容易 OOM；http.FileServer则是流式传输，更稳妥
embed.FS 和 os.DirFS 混用要注意什么
嵌入资源和磁盘文件不能混在同一个 http.FileSystem 实例里，embed.FS 是只读虚拟文件系统，os.DirFS 是真实目录，二者类型不兼容。
- 想打包成单文件，就全用
embed.FS+http.FS()；别试图在 embed 里再调os.Open -
embed.FS不支持运行时写入，所有路径必须在编译期确定；//go:embed static/*中的static/*是硬编码模式，不能用变量替换 - 调试时若发现嵌入文件没生效，先确认
//go:embed注释是否紧贴变量声明、前面没空行，且文件路径相对于.go文件所在目录
最易忽略的一点：MIME 类型默认靠扩展名推断，但 .webp、.avif 等新格式 Go 标准库不识别，浏览器会当成 text/plain 拒绝加载——得手动注册 mime.AddExtensionType。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
