根本原因是Gin静态路径映射严格匹配且不自动纠错；需确保./static为相对于main.go的绝对路径、无尾部斜杠、Windows下统一分隔符，并手动注册根路由返回index.html。
为什么 r.Static("/static", "./static") 返回 404？
根本原因不是 Gin “不工作”，而是路径映射严格匹配，且不自动纠错。常见现象是浏览器控制台报 /static/js/app.js 404，但文件明明存在。
- 确认
./static目录真实存在，且路径相对于main.go所在位置 —— 启动前加一行fmt.Println(filepath.Abs("./static"))看实际解析路径 - Windows 下混用
\和/会导致os.Stat失败；统一用filepath.ToSlash(filepath.Abs("./static")) -
r.Static("/static", dir)的第二个参数必须是磁盘上的**完整目录路径**，不能带尾部斜杠（"./static/"错，"./static"对） - 若前端构建产物在
./dist/static，就绝不能写r.Static("/static", "./static")，而应写r.Static("/static", "./dist/static")
如何让 / 自动返回 index.html？
Gin 的 Static 不处理根路径或 SPA fallback，它只响应明确存在的文件路径。直接访问 http://localhost:8080/ 会 404，除非你手动注册。
- 最简方案：显式注册根路由
r.GET("/", func(c *gin.Context) { c.File("./dist/index.html") })—— 注意路径必须真实存在，且相对main.go - SPA 场景推荐用
r.NoRoute兜底，但必须放在所有其他路由（包括r.GET("/api/...")）之后，否则会拦截合法 API 请求 - 别用
c.Redirect补斜杠或跳转到/index.html—— 这暴露内部结构，且增加一次 HTTP 往返 -
c.FileFromFS不会自动查index.html，若想支持子目录 fallback（如/about），需在 handler 中判断路径是否为目录，再手动拼index.html路径
生产环境缓存头和 MIME 类型为什么没生效？
r.Static 默认只设基础 Content-Type，不发 Cache-Control，也不支持自定义 MIME 映射。结果就是 JS/CSS 被浏览器拒绝执行，CDN 无法缓存。
- JS、CSS 文件类型错误常导致白屏，用
curl -I http://localhost:8080/static/js/app.js检查响应头中的Content-Type - 手动包装 Static handler 设置缓存：
r.Use(func(c *gin.Context) { if strings.HasPrefix(c.Request.URL.Path, "/static/") { c.Header("Cache-Control", "public, max-age=31536000") } }) - 启用 gzip 前先确认前端产物已压缩（如 Webpack 的
compression-webpack-plugin），否则 Gin 的gzip中间件对未压缩大文件反而拖慢响应 - CDN 部署前，建议在构建阶段替换 HTML 中的资源路径（如
/static/→https://cdn.example.com/），避免运行时依赖配置
静态文件和模板目录能不能放一起？
不能。Gin 在加载模板时会递归扫描目录，如果把 static/ 放进 template/ 下，r.LoadHTMLGlob("template/**/*") 会尝试把 JS/CSS 当模板解析，直接 panic 报错。
立即学习“go语言免费学习笔记（深入）”；
- 错误示例：
template/admin/static/js/app.js→ 启动失败，提示“template: ... is not a valid template” - 正确做法：静态资源和模板物理隔离，比如
./template/存 HTML，./static/存 JS/CSS/img - 多个前端入口（如
/admin和/front）时，不要共用同一份index.html名 —— Gin 的c.HTML会因模板名冲突报 “undefined” - favicon.ico、robots.txt 这类固定路径文件，用
r.StaticFile("/favicon.ico", "./static/favicon.ico")单独托管更安全，不参与目录通配逻辑
