静态资源路径必须与html引用严格对齐，r.static第一个参数需匹配script/link的url前缀，第二个参数为相对于main.go的真实目录；r.noroute须置于api和静态路由之后；embed需用r.staticfs且禁用r.static，避免radix树冲突。
静态资源路径必须和HTML中引用路径严格对齐
前端打包产物里写的 /static/js/app.js，后端就必须用 r.Static("/static", "./dist/static") 挂载，否则浏览器404。这不是“差不多就行”的事，URL前缀和磁盘路径是硬匹配关系。
- 检查
index.html里所有<script src="..."></script>、<link href="...">的路径开头，就是r.Static()第一个参数的值 - 第二个参数必须是真实存在的本地目录，且路径相对于
main.go所在位置——用fmt.Println(filepath.Abs("./dist/static"))验证 - Windows 下路径分隔符不用管，Go 的
os.FilePath会自动转换，但别手写"./dist\static"这种混合写法
NoRoute兜底必须放在所有API路由注册之后
r.NoRoute() 不是“默认首页”，而是“未命中任何显式路由时的最终 fallback”。如果把它写在 r.GET("/api/user") 前面，所有 API 请求都会被它吃掉，返回 index.html 而不是 JSON。
- 顺序必须是：API 路由 → 静态资源挂载（
r.Static()）→r.NoRoute() -
c.File("./dist/index.html")内部做了路径安全校验，比c.String()或重定向更可靠 - 若需支持子路径（如
/admin/user），确保前端路由也配成history模式，否则刷新页面仍 404
embed嵌入静态文件时，StaticFS路径要带前缀且避免冲突
用 //go:embed static/dist/* 把前端打包产物打进二进制后，不能再用 r.Static()，得改用 r.StaticFS("/static", http.FS(embeddedFS))，否则会 panic。
-
http.FS()包裹 embed.FS 是必须步骤，直接传embed.FS类型不兼容 -
r.StaticFS("/static", ...)的 URL 前缀必须和 HTML 中引用一致，和r.Static()规则完全一样 - 别在 embed 后还留着
r.Static()调用——两个同前缀的静态服务注册会触发 Radix 树冲突，报wildcard route conflicts with existing children
路由树里静态路径永远优先于动态段，但注册顺序决定树结构
你写 r.GET("/user/new", ...) 和 r.GET("/user/:id", ...)，Gin 不是“最长匹配”，而是按 Radix 树节点静态性判断。如果 /user/:id 先注册，/user/new 就会被吞掉，哪怕它更具体。
- 启动时盯紧
[GIN-debug]日志，看GET /user/new和GET /user/:id谁先打印——先打印的才真生效 - Group 不改变树构建逻辑：
v1 := r.Group("/v1"); v1.GET("/users/new", ...)实际注册的是/v1/users/new，仍需排在/v1/users/:id前面 - 通配符
*filepath必须末尾带斜杠：/static/*filepath可以，/static/*file会 panic
go run 时当前目录是 main.go 所在位置，但 go build 后二进制运行时默认目录是执行位置，embed 则完全脱离文件系统——三者路径语义不同，不能混用一套假设。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
