staticembedded 更适合生产打包，因其将静态资源编译进二进制，不依赖磁盘路径与os权限，部署零配置、无外部依赖；而staticweb依赖系统调用和文件权限，易在ci/cd多环境下发导致404。
StaticEmbedded 为什么比 StaticWeb 更适合生产打包
因为 StaticEmbedded 把文件编译进二进制，不依赖磁盘路径和 OS 文件权限，部署时零配置、无外部依赖。而 StaticWeb 每次请求都走系统调用打开文件，开发调试方便，但上线后容易因路径错、权限不足或容器挂载遗漏导致 404 —— 尤其在 CI/CD 自动构建 + 多环境分发场景下，StaticEmbedded 是更可控的选择。
嵌入资源前必须加 //go:embed，且路径是 embed.FS 内部路径
常见错误是把磁盘路径当 embed 路径用，比如项目结构是 ./dist/css/app.css，却写成：
// ❌ 错误：embed 声明路径与实际目录结构不符
//go:embed dist
var assetFS embed.FS
// 然后调用 app.StaticEmbedded("/assets", assetFS, "dist") —— 这里 "dist" 是 embed.FS 的根子目录名
// ✅ 正确：确保 //go:embed 后的路径能匹配到你要嵌入的整个目录
//go:embed dist
var assetFS embed.FS
// 或者只嵌 dist 下的子目录（如仅嵌 js）
//go:embed dist/js
var jsFS embed.FS
// 对应 app.StaticEmbedded("/js", jsFS, "dist/js") —— 注意第三个参数必须是 embed.FS 中存在的路径
- 如果嵌入时用了
os.DirFS("./dist")混淆，编译会失败或运行时报fs: embedded directory not found -
//go:embed必须放在包级变量声明上方，不能在函数内、不能带空行隔开 - 嵌入空目录会静默失败，建议先
ls -R dist确认结构
StaticEmbedded 路由注册后，访问路径和文件路径怎么对应
app.StaticEmbedded("/assets", assetFS, "dist") 的三个参数含义是：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 第一参数
"/assets"：HTTP 访问前缀，比如请求/assets/main.js - 第二参数
assetFS：embed.FS 实例，即你用//go:embed加载进来的只读文件系统 - 第三参数
"dist"：该 FS 中的起始子目录名（不是磁盘路径），Iris 会从这里开始查找main.js
也就是说，http://localhost:8080/assets/main.js → 实际读取的是 embed.FS 中 "dist/main.js"。如果文件在 dist/js/main.js，那请求地址就得是 /assets/js/main.js，否则 404。
嵌入式资源不支持热更新，改了 dist 必须重新编译
这是最常被忽略的一点：修改 dist/ 下任何文件后，go run main.go 不会自动生效；必须 go build 或 go run 重新编译，否则看到的还是旧资源。开发阶段可临时切回 StaticWeb，但上线前务必确认已切为 StaticEmbedded 并完成编译。
另外，嵌入后无法用 os.Stat 或 fs.ReadFile 直接操作这些文件——它们不在磁盘上，只能通过 assetFS.Open() 或 Iris 内部机制访问。
