Beego 作为后端框架不提供前端脚手架，其 static 目录用于托管静态资源而非接收构建产物；应将 Vue 等构建输出（如 dist）放入 static/dist 子目录，通过 {{.StaticUrl}}/dist/ 引用，并配置兜底路由支持 SPA history 模式。
Beego 本身不提供前端脚手架，它是个后端框架；所谓“前端打包”实际是把静态资源（js、css、images）整合进 Beego 项目并由其统一托管，而不是用 Vue CLI 或 Vite 打包前端工程。混淆这点会导致路径错乱、热更新失效、bee run 启动失败等典型问题。
beego 的 static 目录不是“前端构建输出目录”
很多人把 static 当成类似 dist 的构建产物存放地，直接把 Vue/React 构建完的 dist 整个拷进去 —— 这会破坏 Beego 的静态文件路由逻辑，且无法配合 bee run 热重载生效。
-
static是 Beego 默认服务静态资源的根路径，但只接受原始源文件（如static/js/app.js），不自动处理构建依赖或哈希文件名 - 若你用 Webpack/Vite 构建，应配置
build.outDir指向static/dist（而非覆盖static），并在模板中用{{.StaticUrl}}/dist/app.[hash].js引用 - Beego 不解析
index.html中的import或require，所以前端构建必须独立完成，Beego 只做托管和路由代理
如何让 bee run 正确加载前端资源
关键在 app.conf 和模板路径配置。默认情况下 bee run 会自动映射 /static/xxx 到项目根目录下的 static/xxx，但以下几点极易出错：
- 确保
app.conf中未手动修改StaticDir，否则bee run会忽略默认行为；若需自定义，应设为相对路径：StaticDir = "static" - 模板中引用静态资源时，不要硬编码
/static/，改用 Beego 提供的函数：{{.StaticUrl}}/js/main.js（.StaticUrl值由beego.SetStaticPath()或配置决定） - 开发时若启用了前端 dev server（如
vite dev），需在 Beego 中配置反向代理避免跨域：beego.InsertFilter("/api/", beego.BeeApp.Handlers, &proxy.Filter{Target: "http://localhost:5173"})（需引入github.com/beego/beego/v2/server/web/filter/proxy）
打包时静态资源被遗漏的常见原因
bee pack 默认只打包 conf、static、views、main.go 及其依赖的 Go 源码，不会扫描前端构建产物中的动态生成文件（如带 hash 的 JS/CSS）。
立即学习“前端免费学习笔记（深入）”；
- 若构建产物含哈希文件名（如
app.a1b2c3.js），必须在构建后运行脚本将其重命名为固定名（如app.js），或提前在模板中用变量注入真实文件名 -
bee pack -be GOOS=linux不会自动执行前端构建命令，需在打包前手动运行npm run build并确认产物已落盘到static/下指定子目录 - 检查
bee pack输出日志中是否包含packing static/...行；若无，说明static目录不存在或权限不足
最常被忽略的是：Beego 的静态服务不支持 SPA 的 history fallback，前端路由（如 Vue Router 的 history 模式）需要在 Beego 中显式配置兜底路由，否则刷新页面会返回 404 —— 这不是打包问题，但常被误认为资源没加载成功。
