r.staticfs("/","staticfs")导致api接口404，因其注册最高优先级通配路由，拦截所有未匹配请求（如/api/users）并查找文件，失败即404；正确做法是限定前缀（如/static/）、用fs.sub切出dist目录、显式注册get "/"和noroute兜底index.html，并确保api路由注册在staticfs之前。
直接用 gin.Engine.StaticFS 挂载 embed.FS 是最常见做法，但不加处理会立刻踩进路由优先级、SPA fallback 和路径映射三重坑里。
为什么 r.StaticFS("/","staticFS") 会让 API 接口 404？
因为 StaticFS 默认注册的是最高优先级的通配路由，它会拦截所有未匹配的请求（包括 /api/users），然后去文件系统里找对应路径 —— 显然找不到，就返回 404。这不是 bug，是设计如此。
- 必须显式限定静态资源前缀，比如
/static/或/assets/，避免覆盖 API 路由 - 若想让前端 SPA 的
/user/profile路由也能被正确服务，得手动补 fallback 逻辑，不能只靠StaticFS -
StaticFS不支持自动查找index.html，访问/会 404，除非你额外注册GET "/"并显式返回它
如何正确挂载并支持 Vue/React 的 SPA 路由？
核心是分层处理：API 路由走 Gin 原生路由，静态资源走文件系统，SPA 根路径和子路径兜底到 index.html。
- 先用
fs.Sub切出前端构建输出目录（如dist/），避免嵌入冗余路径层级 - 注册
GET "/"和GET "/*any"两个路由，都返回index.html内容（用embed.FS.ReadFile或Open） - 再用
r.StaticFS("/static", http.FS(distFS))暴露assets/等子资源，确保 JS/CSS/image 能正常加载 - 注意：
/*any必须放在所有 API 路由之后，否则会劫持接口请求
embed.FS 路径写错会导致编译失败还是运行时 panic？
编译期就失败。Go 编译器会严格校验 //go:embed 后面的路径是否存在、是否可读、是否在模块根目录内。
- 路径必须相对于当前 Go 源文件所在目录，不是工作目录或
go.mod目录 - 不能用
../跨出模块根目录，否则报错invalid pattern: .. outside module root - 通配符
*不匹配隐藏文件（以.开头），如.gitignore不会被嵌入 - 如果嵌入空目录，
fs.Sub会成功，但后续Open("index.html")仍会返回fs.ErrNotExist
开发时怎么热更新前端资源而不重编译 Go？
做不到。embed 是编译期行为，任何改动都需重新 go build。开发阶段建议绕过 embed：
- 用
r.Static("/static", "./dist/assets")直接读取本地构建产物 - 前端启动
vite dev server或vue-cli-service serve，后端 API 配置代理（如 Gin 的gin-contrib/cors+ 前端跨域） - 仅在
GOENV=production go build时启用 embed，通过构建标签（//go:build prod）隔离逻辑
最容易被忽略的是 fs.Sub 的路径参数 —— 它要求第二个参数必须是 embed.FS 中真实存在的目录名，少一个斜杠、多一层嵌套，都会导致 Open 返回 fs.ErrNotExist，且错误信息里完全不提示原始嵌入路径，只能靠打印 embed.FS.ReadDir 结果来排查。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
