embed.fs 不能直接读取 node_modules，因其仅支持编译时静态路径，而 node_modules 动态生成、含符号链接和二进制文件，go 编译器设计上不支持；正确做法是先构建前端为 dist/ 或 build/ 静态产物再 embed。
embed.FS 能不能直接读取 node_modules？
不能。Go 的 embed.FS 只支持编译时静态已知的文件路径，而 node_modules 是构建时动态生成、体积巨大、含大量符号链接和二进制文件的目录，Go 编译器会直接报错或跳过——不是权限问题，是设计上不支持。
正确做法是：前端必须先构建为纯静态产物（dist/ 或 build/），再 embed 这个产出目录。
- Vue 项目用
npm run build，确认输出在dist/ - React 项目用
npm run build，默认输出在build/ - 确保构建后所有资源（HTML、JS、CSS、图片）都扁平化存在于单层目录下，避免嵌套过深导致路径匹配失败
- 构建前清空目标目录，防止旧文件残留被 embed 进去
如何让 http.FileServer 正确服务 index.html 和 SPA 路由
直接把 embed.FS 传给 http.FileServer 会导致所有非根路径（比如 /user/profile）返回 404，因为前端路由是客户端处理的，但 Go 服务器不知道该回退到 index.html。
必须自己写一个 fallback handler，优先匹配真实文件，找不到时才返回 index.html。
立即学习“go语言免费学习笔记（深入）”；
- 用
fs.Sub切出子文件系统，例如fs.Sub(embeddedFS, "dist")，避免路径越界 - 不要用
http.StripPrefix后直接接http.FileServer，它不会 fallback - 推荐用
http.ServeFile手动兜底：先f, err := fs.Open(path)，err != nil 时再http.ServeFile(w, r, "dist/index.html") - 注意：
index.html的 MIME 类型要显式设为text/html; charset=utf-8，否则某些浏览器可能解析失败
开发时热更新和生产 embed 怎么共存
硬编码 //go:embed dist 会让开发调试变得痛苦——每次改前端都要重新 go run，失去 webpack/Vite 的热更新能力。
解决方案是条件编译 + 环境切换，而不是写两套逻辑。
- 用
build tag分离：生产用//go:build prod+//go:embed dist，开发用//go:build dev+os.DirFS("dist") - 启动时检查环境变量，如
os.Getenv("ENV") == "dev"，决定用embed.FS还是本地os.DirFS - 切记：开发模式下别 embed，否则
go:embed会强制要求dist/存在，CI 构建可能失败 - Vite 或 Vue CLI 的代理可照常配
proxy到后端 API，和 Go 二进制无关
为什么打包后 CSS/JS 路径 404 或加载空白
常见原因是前端构建配置里的 publicPath（Vue）或 homepage（React）没设对，导致生成的 HTML 中引用了 /static/js/xxx.js 这类绝对路径，而你的 Go 服务根路径不是 /，或者没挂载到对应位置。
- Vue CLI：在
vue.config.js中设publicPath: "./"（相对路径） - Vite：在
vite.config.ts中设base: "./" - React（Create React App）：在
package.json加"homepage": "." - 构建后打开
dist/index.html用浏览器直接双击打开，如果 JS/CSS 也 404，说明是前端配置问题，不是 Go 代码问题 - 检查生成的 HTML 中 script 标签的
src是否以./开头，而不是/或https://
. vs /），整个页面就白屏。 
