go:embed 加载 dist/ 报错“pattern matches no files”主因是前端未构建、路径不在源码根目录、声明位置错误或大小写不匹配；需确保 npm run build 已执行、dist/ 与 .go 同级、//go:embed 紧邻包级变量且路径准确，推荐显式指定入口文件与子目录如 dist/index.html dist/assets/*。
go:embed 不能直接嵌入整个前端构建目录的产物，必须明确指定文件路径或使用通配符匹配，且目标路径在编译时必须存在、不可动态变更。
为什么 go:embed 加载 dist/ 总是报错 pattern matches no files
常见错误是把前端构建还没执行完就跑 go build，或者 embed.FS 声明的位置不对（必须在包级变量）、路径写成相对当前工作目录而非源码目录。Go 编译器只认源码树下的路径，dist/ 必须和 .go 文件在同一项目根下，且构建后生成的文件要先落地。
- 确保
npm run build或pnpm build已执行完毕，dist/目录真实存在于 Go 源码根目录 -
go:embed语句必须写在包级变量声明前，且紧邻其上，中间不能有空行或注释 - 路径区分大小写，Linux/macOS 下
Dist/和dist/是两个路径 - 不能用
../dist跨出 module 根目录，否则编译失败
go:embed 如何安全嵌入 dist/ 下全部静态资源
最稳妥的方式是显式列出关键入口文件 + 通配子目录，避免意外嵌入 .gitignore 里本该排除的临时文件（如 dist/.vite）。不建议无脑 go:embed dist/**，因为某些构建工具会在 dist/ 写入不可读文件（如 socket 或锁），导致 embed 失败。
- 推荐写法：
//go:embed dist/index.html dist/assets/*
—— 显式控制范围，兼顾 HTML 和打包后的 JS/CSS - 如果要用递归通配，必须加引号：
//go:embed "dist/**"
，否则 shell 可能提前展开 - 嵌入后通过
fs.ReadFile("dist/index.html")读取，注意路径是 embed 时写的路径，不是运行时的文件系统路径 - 若需服务多个前端路由（如 SPA 的 history fallback），得自己实现
http.FileSystem包装逻辑，embed.FS本身不支持 404 fallback
用 embed.FS 启动静态服务时，CSS/JS 404 的根本原因
不是路径写错了，而是前端构建产物里的资源引用路径（比如 assets/index.123abc.js）和 Go 里 http.FileServer 暴露的 URL 路径不一致。常见于 Vite 默认输出 dist/assets/，但你却用 http.FileServer(http.FS(embededFS)) 直接挂载整个 embed.FS，结果请求 /assets/xxx.js 会去查 assets/xxx.js，而 embed 的实际路径是 dist/assets/xxx.js。
立即学习“go语言免费学习笔记（深入）”；
- 正确做法：用
fs.Sub切出子文件系统：sub, _ := fs.Sub(embededFS, "dist")
，再传给http.FileServer - 检查构建配置：Vite 的
build.assetsDir、Webpack 的output.assetModuleFilename要和你在go:embed中写的路径层级对齐 - 开发时可加日志验证路径是否存在：
_, err := embededFS.Open("dist/assets/index.js")，别只信文档
真正麻烦的从来不是怎么写 go:embed，而是前端构建产物路径、Go 嵌入路径、HTTP 路由路径这三层怎么对齐——少一层相对关系，就多一个 404。
