根本原因是Go进程工作目录（os.Getwd()）不等于项目根目录，导致相对路径"./dist/static"解析错误；必须用filepath.Abs()获取绝对路径并配合filepath.ToSlash()确保Windows兼容，Docker中推荐用os.Executable()定位二进制根目录。
为什么 r.Static("/static", "./dist/static") 经常 404
根本原因不是 Gin 有问题，而是 Go 进程的当前工作目录（os.Getwd()）不等于项目根目录。比如你用 VS Code 点击运行、或从家目录执行 go run /path/to/main.go，这时 "./dist/static" 就会解析成 /home/you/dist/static 而非你期望的 /path/to/project/dist/static。Gin 不报错，只静默返回 404。
r.Static 的路径参数必须是真实可访问的目录绝对路径
它不接受相对路径拼接、不自动补斜杠、也不 fallback 到 index.html。传进去的字符串必须指向一个存在的、可读的目录。
- 若路径末尾带斜杠（如
"./dist/static/"），会导致 URL 匹配失败：请求/static/js/app.js会 404 - Windows 下路径含反斜杠
\时，Gin 内部路径匹配逻辑可能误判，必须用filepath.ToSlash()统一为正斜杠 - 务必检查
filepath.Abs()的返回 err —— 路径不存在或权限不足时，应 panic 或 log.Fatal，不能忽略
正确写法：
absPath, err := filepath.Abs("./dist/static")
if err != nil {
log.Fatal("failed to resolve static dir:", err)
}
absPath = filepath.ToSlash(absPath) // Windows 兼容
r.Static("/static", absPath)
Docker 容器里怎么保证路径可靠
容器内 os.Getwd() 和 filepath.Abs() 依然不可靠：挂载 volume、二进制放在 /app/server、启动命令指定 WORKDIR 都会让相对路径失效。
- 推荐用
os.Executable()反推二进制所在目录，再拼子路径 - 即使二进制被重命名或软链，
os.Executable()仍返回真实路径 - 仍需
filepath.ToSlash()，且最终路径要os.Stat()校验是否存在
示例：
exePath, err := os.Executable()
if err != nil {
log.Fatal(err)
}
rootDir := filepath.Dir(exePath)
staticDir := filepath.Join(rootDir, "dist", "static")
staticDir = filepath.ToSlash(staticDir)
if _, err := os.Stat(staticDir); os.IsNotExist(err) {
log.Fatal("static dir not found:", staticDir)
}
r.Static("/static", staticDir)
r.Static 和 r.StaticFS 对路径的要求其实一样
别被名字误导：r.Static("/static", dir) 内部就是 r.StaticFS("/static", http.Dir(dir))。二者都要求 dir 是干净的、无尾随斜杠的、可访问的目录路径。
-
http.Dir(dir)不做路径标准化，Windows 下仍需filepath.ToSlash() - 两者都不支持自动索引（如访问
/static/不会返回index.html），纯文件映射 - 若需嵌入编译、权限控制或自定义读取逻辑，才用
r.StaticFS配合embed.FS或自定义http.FileSystem
最易被忽略的一点：所有这些路径处理，都发生在服务启动前。一旦 r.Run() 开始监听，就再没机会修正路径 —— 错了就是 404，而且 Gin 默认不打任何日志提示。
