bee不是“装完就能用”的工具，它严格依赖Go环境、$GOPATH/src目录位置及版本匹配；bee new生成含views/static的完整Web项目，bee api则专为前后端分离后端服务设计，禁用模板渲染且默认启用RESTful路由。
bee 不是“装完就能用”的工具，它对 Go 环境、目录位置和版本匹配有明确约束，跳过任一条件都会卡在 bee new 或 bee run 报错。
bee new 和 bee api 的区别与选型依据
两者都生成项目骨架，但结构和默认配置不同：bee new 生成带 views/、static/ 和 HTML 模板的完整 Web 项目；bee api 则省略前端资源目录，routers/router.go 默认启用 beego.NSInclude 风格的 RESTful 路由，并禁用模板渲染。
- 如果你要写前后端分离的后端服务（如对接 Vue/React），直接用
bee api myservice，避免后续手动删views和关模板引擎 - 如果你要做带登录页、后台管理界面的传统 Web 应用，选
bee new adminpanel - 二者生成的
main.go入口一致，但conf/app.conf中autorender = true（new） vsautorender = false（api）会影响context.Output.JSON()的自动包装行为
bee run 热编译失效的常见原因
bee run 依赖 fsnotify 监控文件变更，但在某些场景下会静默停止监听或不触发重编译。
- 项目不在
$GOPATH/src下（Go 1.16+ 后虽支持模块，但bee仍默认按 GOPATH 模式扫描，尤其 v2 版本） - 编辑器保存时用了“原子写入”（如 VS Code 默认行为），导致临时文件替换引发 inotify 事件丢失 —— 可在 VS Code 设置中关闭
"files.useExperimentalFileWatcher": false - Windows 上杀毒软件拦截了文件系统事件，临时禁用实时防护常能恢复
- 修改了
conf/app.conf但未改动 Go 文件，bee run不会重载配置 —— 此时需手动Ctrl+C再bee run
bee generate controller/model 的实际限制
bee generate controller 和 bee generate model 是代码脚手架，不是 ORM 工具，它只生成空结构体和基础方法框架，不处理数据库迁移或字段映射。
- 生成的
controller默认继承beego.Controller，但不会自动注册路由 —— 你仍需手动在routers/router.go中调用beego.Router或NSInclude -
bee generate model User仅创建models/user.go，含空type User struct{}，无orm标签、无表名定义、不关联数据库 - 若项目已启用 beego ORM（
beego.ORMRegisterModel），需额外在models/register.go中手动添加_ = orm.RegisterModel(new(User)) - 生成的文件名和结构体名严格按参数小写/大写转换（
bee generate controller OrderHandler→ 文件orderhandler.go，结构体OrderHandlerController）
bee pack 打包时 GOOS/GOARCH 的坑
bee pack 本质是调用 go build 后打包，但它的 -be 参数容易被误解为“跨平台编译开关”，其实只是透传环境变量给底层 go build。
- 执行
bee pack -be GOOS=linux GOARCH=amd64前，必须确保本地 Go 安装支持该目标平台（go version -m ./myapp可验证） - Windows 下用
bee pack -be GOOS=linux打出的二进制无法直接运行，仅用于部署到 Linux 服务器 —— 这不是 bug，是 go build 的正常行为 - 若项目用了 cgo，跨平台打包大概率失败，需提前设
CGO_ENABLED=0，否则报exec: "gcc": executable file not found -
bee pack默认压缩整个项目目录（含conf/、static/），但不会自动排除.git或tests/—— 如需精简，得先手动清理再打包
真正麻烦的从来不是命令记不住，而是 bee 在 GOPATH 模式和 Go Modules 模式之间摇摆，以及它对文件系统事件的底层依赖 —— 这两点在 CI/CD 或容器化构建里最容易暴露，别等上线才发现热编译没生效、打包产物跑不起来。
