beego项目结构无标准答案但有严格约定：bee new生成的目录不可随意改名或挪动，因自动扫描、代码生成、路由注册、ORM初始化均依赖固定路径与包名统一（如controllers包名必须为controllers），否则导致编译失败、路由找不到、ORM不识别等踩坑问题。
beego 项目结构没有“标准答案”，但有明显踩坑区：目录混乱导致 bee generate 失效、models 和 controllers 包路径错位引发 import 循环、router.go 找不到控制器类型——这些不是配置问题，是结构约定被破坏的直接后果。
bee new 生成的结构为什么不能直接改名或挪动？
beego 的自动扫描和代码生成严重依赖固定路径。比如 bee generate controller user 默认往 controllers/ 下写文件，并假设该包导入路径为 yourapp/controllers；若你把 controllers 改成 handlers，bee run 启动时仍会去加载原路径，而 beego.Router 中写的 &controllers.UserController{} 会编译失败。
-
conf/app.conf里appname值必须与项目根目录名一致，否则bee pack会打包出错 -
main.go中的import _ "yourapp/routers"是硬编码路径，改了routers目录名就得同步改这行 -
models/下的结构体若没放在models包里（比如误建在models/db子包），bee generate model生成的 ORM 注解无法被orm.RegisterModel正确识别
controller 层命名与路由注册不匹配的典型表现
常见错误是控制器文件名、结构体名、包名三者不统一，导致 beego.Router 找不到目标类型。例如在 controllers/api/user.go 里定义了 type UserController struct，但包声明是 package api，那么路由注册必须写成 &api.UserController{}，而不是 &controllers.UserController{}。
- 推荐做法：所有控制器统一放在
controllers/根目录下，包名全为controllers，结构体名以Controller结尾（如UserController） - RESTful 路由中
"get:List;post:Create"对应的方法必须是首字母大写的导出方法，且签名固定为func(*UserController) List() - 若用子目录组织（如
controllers/admin/），需确保子目录下包名仍是controllers，否则bee run无法自动扫描到
models 目录被忽略或 ORM 初始化失败的根源
beego ORM 不会自动扫描 models/ 下所有结构体，必须显式调用 orm.RegisterModel 或使用 orm.RegisterModel(new(User), new(Order))。很多项目把模型分散在 models/user.go、models/order.go，却只在 models/models.go 里注册了一部分，结果部分表不建、关联查不出。
- 初始化 ORM 必须在
main.go的init()或main()开头执行，早于beego.Run() -
models/下每个结构体都应带orm:"table(user)"标签，否则默认表名是复数小写（users），容易和已有表名冲突 - 避免在
models/里 importcontrollers或views，Go 的 import 循环检测会在构建时报import cycle
最易被忽略的是 routers/router.go 的加载时机——它必须在 ORM 初始化之后、beego.Run() 之前执行，否则 beego.Router 注册的控制器里若用了 o := orm.NewOrm()，可能拿到未初始化的 ORM 实例，静默失败而非报错。
