Go全栈项目开发阶段必须分离前后端：Vite等开发服务器依赖HMR、动态import和sourcemap，http.FileServer无法提供；生产阶段用embed将dist目录嵌入二进制，配合http.StripPrefix与SPA fallback实现单文件交付。
Go 全栈项目不是把前端代码塞进 main.go，而是用明确分工 + 轻量集成实现单二进制交付。开发阶段前后端必须分离运行，生产才合并打包。
开发时为什么不能用 Go 的 http.FileServer 直接 serve 前端源码
Vite/React/Vue 的开发服务器依赖内存编译、WebSocket 热更新（HMR）、动态 import 和 sourcemap，这些能力 http.FileServer 完全不提供。
- 常见错误现象：
Failed to load source map、Cannot fetch dynamically imported module、页面白屏但控制台无报错 - 如果你把
vite.config.ts的server.host改成"0.0.0.0"，再让 Go 的FileServer指向src/或空dist/，实际加载的是过期或缺失的文件 - 正确做法：前端始终用
npx vite启动，Go 只监听:8080提供 API；跨域由 Vite 的proxy解决，而非 Go 加CORS中间件
生产构建时如何用 embed 把前端 dist 打进 Go 二进制
Go 1.16+ 的 embed 是唯一推荐的静态资源嵌入方式，无需外部文件、不依赖路径、零部署配置。
- 在
backend/main.go顶部加：//go:embed dist/*，然后声明var distFS embed.FS - 注册路由时必须处理 SPA fallback：用
http.FileServer(http.FS(distFS))，再套一层http.StripPrefix和自定义 handler 捕获 404 并返回index.html - 不要用
http.Dir("dist")—— 这会绕过embed，导致构建后找不到文件 - 构建命令保持简洁：
go build -o app ./backend，生成的app就是完整服务，连dist/目录都不需要存在
Gin 或 net/http 托管静态资源时的路由冲突怎么避
API 路由（如 /api/users）和静态路由（如 /、/assets/）必须严格隔离，否则 index.html 会拦截 API 请求，返回 HTML 而非 JSON。
立即学习“go语言免费学习笔记（深入）”；
- 在 Gin 中，用
r.StaticFS("/assets", http.FS(distFS))显式挂载静态子路径，主路由r.NoRoute()里 fallback 到index.html - 用
net/http时，别直接http.Handle("/", ...)，改用http.StripPrefix("/static", http.FileServer(...))分离前缀 - 测试关键点：访问
/api/users必须返回 JSON；访问/nonexistent必须返回index.html状态码 200；访问/assets/main.js必须返回 JS 内容且状态码 200
最容易被忽略的是 embed 的路径匹配细节：dist/* 不包含 dist 目录本身，而 dist/** 才递归包含子目录；如果前端构建产物里有 dist/css/app.css，但 embed 写成 dist/*，那 css/ 这层会被截断——得用 dist/** 或确保构建输出扁平化。
