go run能加载./static而编译后404，是因为相对路径基于当前工作目录而非二进制位置；应使用os.Executable()获取二进制路径，再通过filepath.Join和filepath.Abs构建绝对路径，并用filepath.ToSlash标准化分隔符。
为什么 go run 能加载 ./static，但编译后运行就 404？
因为 Go 程序里所有相对路径（比如 "./static"）都基于当前工作目录（os.Getwd()），而不是二进制文件位置。你用 go run main.go 时，工作目录通常是项目根目录；但执行 ./bin/myapp 时，工作目录是 ./bin，程序就会去 ./bin/static 找文件——自然失败。
这不是 Gin 的 bug，是 Go 运行时行为本身决定的。别指望靠 cd 切换目录来“修复”，线上部署没法保证用户一定在哪儿执行二进制。
- 用
os.Executable()获取二进制绝对路径，再用filepath.Dir()和filepath.Join()构建资源路径 - 假设静态文件放在二进制同级的
static/目录下，代码写成：filepath.Join(filepath.Dir(exePath), "static") - 务必调用
filepath.Abs()转成绝对路径，避免../在不同环境解析出错 - Windows 下路径分隔符可能混用（
\vs/），统一用filepath.ToSlash()输出给 Gin
r.Static("/static", "./static") 为什么在某些机器上失效？
这个写法只在工作目录恰好等于源码目录时才可靠。它隐含了两个易被忽略的前提：一是 ./static 相对于当前工作目录存在，二是路径中不含 Windows 特有的反斜杠。一旦打包部署或跨平台运行，这两个前提大概率不成立。
真正健壮的写法是把磁盘路径算清楚再传给 r.Static：
立即学习“go语言免费学习笔记（深入）”；
- 先获取可执行文件路径：
exePath, _ := os.Executable() - 推导静态目录：
staticDir := filepath.Join(filepath.Dir(exePath), "..", "static") - 转绝对路径并标准化分隔符：
absDir, _ := filepath.Abs(staticDir); absDir = filepath.ToSlash(absDir) - 最后注册：
r.Static("/static", absDir)
注意：不要在 URL 前缀（第一个参数）末尾加斜杠，r.Static("/static/", dir) 会导致匹配失败；也不要让本地路径带尾部斜杠，r.Static("/static", dir+"/") 同样会出问题。
如何让 / 和 /about 都返回 index.html？
Gin 的 r.Static() 是纯路径映射，不处理 SPA 的 fallback。它不会自动把 /about 当作 /index.html 返回，也不会在请求目录时补 /index.html。
最稳妥的做法是用 r.NoRoute() 兜底，但必须确保它在所有其他路由（包括 r.GET("/api/...")）之后注册：
- 先注册所有 API 路由、静态路由
- 最后加：
r.NoRoute(func(c *gin.Context) { c.File(filepath.ToSlash(filepath.Join(staticDir, "index.html"))) }) - 注意这里不能用
c.FileFromFS，因为它不自动查找index.html；也不能用c.Redirect，会暴露真实路径且多一次 HTTP 跳转
如果只希望根路径 / 返回 index.html，那就单独写 r.GET("/", func(c *gin.Context) { c.File(...) })，更轻量也更可控。
生产环境里还有哪些容易被忽略的细节？
开发时能跑通，不代表上线没问题。几个高频翻车点：
-
Cache-Control头没设 —— 浏览器缓存旧 JS/CSS，改了代码也不生效；建议用中间件对/static/*加c.Header("Cache-Control", "public, max-age=31536000") - MIME 类型缺失或错误 —— 某些 CDN 或代理会因
Content-Type不对而拒绝响应；Gin 默认 MIME 表不全，可手动用gin.SetMode(gin.ReleaseMode)并配合自定义http.ServeContent控制 - CDN 路径没替换 —— 前端构建时生成的
index.html里引用的是/static/xxx.js，但你实际托管在https://cdn.example.com/v1.2.3/；得在构建阶段用 sed 或模板变量提前替换掉路径前缀
路径问题从来不是“配对就行”的事，而是要从二进制落地位置、OS 路径语义、HTTP 协议约束三个层面同时校准。少盯一眼，上线就白屏。
