静态资源404、页面白屏、JS不执行，根本原因是r.Static()路径配置错误或未兜底index.html：第一个参数是URL前缀（如"/static"），第二个是磁盘路径（如"./dist/static"），顺序不可颠倒；SPA需在所有API路由后用r.NoRoute兜底c.File("./dist/index.html")。
静态资源 404、页面白屏、JS 不执行，基本都是 r.Static() 路径配错了，或者没兜底 index.html —— 不是前端打包问题，是 Gin 路由没对上磁盘文件。
确认 r.Static() 的两个参数顺序和含义
r.Static() 第一个参数是 URL 前缀（浏览器访问路径），第二个参数是本地磁盘路径（Go 进程能读到的绝对/相对路径），二者绝不能颠倒。
- 常见错误：
r.Static("./dist/static", "/static")—— 这会把 URL/static映射到磁盘路径./dist/static，但 Gin 实际要求的是r.Static("/static", "./dist/static") - 验证方式：启动服务后，直接用 curl 或浏览器访问
http://localhost:8080/static/js/app.js，返回文件内容才算通；若 404，立刻检查当前工作目录是否为main.go所在目录（可用fmt.Println(filepath.Abs("./dist/static"))打印真实路径） - 注意 Windows 路径兼容：Go 内部自动处理
/和\，但手动拼接路径时别混用；推荐统一用filepath.Join("dist", "static")替代字符串拼接
SPA 场景下必须用 NoRoute 兜底 index.html
r.Static() 只匹配物理文件，不处理前端路由（如 /user/profile）。直接访问根路径 / 也会 404，除非显式注册或兜底。
- 错误做法：
r.GET("/", func(c *gin.Context) { c.File("./dist/index.html") })—— 仅解决首页，/about仍 404 - 正确做法：所有 API 路由（如
r.GET("/api/user")）注册完后，最后一行加r.NoRoute(func(c *gin.Context) { c.File("./dist/index.html") }) - 关键约束：
NoRoute必须放在所有r.GET/r.POST等显式路由之后，否则会拦截/api/xxx请求 - 确保
./dist/index.html物理存在，且路径相对于main.go—— 若项目结构是project/main.go+project/dist/index.html，就写c.File("./dist/index.html")，不是"dist/index.html"或"/dist/index.html"
单独托管 favicon.ico 和 robots.txt
这类固定路径文件不适合塞进 Static() 目录，容易被误删或路径错位；用 StaticFile() 更精准、更安全。
立即学习“go语言免费学习笔记（深入）”；
- 写法：
r.StaticFile("/favicon.ico", "./dist/favicon.ico")、r.StaticFile("/robots.txt", "./dist/robots.txt") - 优势：不依赖目录结构，不参与通配匹配，只要文件存在就能命中；Gin 自动设置
Content-Type，无需手动指定 - 注意：路径参数必须是完整磁盘路径，不能是目录；如果
favicon.ico不在./dist/下，得按实际位置写，比如"./public/favicon.ico"
生产环境上线前要检查三件事
开发跑通不等于线上能用。Windows 开发、Linux 部署时最容易翻车。
- 工作目录：Linux 上用
systemd或supervisord启动时，os.Getwd()往往不是你预期的项目根目录 —— 建议用os.Chdir()强制切换，或改用绝对路径（如/var/www/myapp/dist） - MIME 类型加固：Gin 默认推断 MIME，但某些自定义扩展名（如
.wasm）可能识别失败，可在Static()后手动注册：http.ServeContent或用中间件补全 - 缓存头控制：默认不带
Cache-Control，静态资源建议加r.StaticFS("/static", http.Dir("./dist/static"))配合自定义http.FileSystem实现缓存策略，而非依赖Static()的默认行为
