beego v2标准目录结构必须包含conf/、controllers/、routers/、models/、static/、views/；缺任一目录会导致beego.run()静默跳过加载，如conf/缺失报错open conf/app.conf: no such file or directory，routers/缺失则路由无法自动注册。
Beego 项目目录结构不是“可自由发挥”的设计，而是框架强约定的结果；手动增删目录或改名会导致 bee run 启动失败、路由注册丢失、模板找不到等隐性问题。
beego v2 的标准目录结构必须包含哪些目录
从 bee new myapp 生成的结构是唯一被官方工具链（bee、beego/server/web 初始化逻辑）识别的基线。缺以下任一目录，main.go 中的 beego.Run() 可能静默跳过模块加载：
-
conf/：必须存在，即使只放一个空app.conf；否则beego.BConfig初始化报错open conf/app.conf: no such file or directory -
controllers/：必须存在且小写；若命名为Controller/或ctrl/，routers/router.go中的beego.Router仍能注册，但bee run热重载时不会监听该目录变更 -
routers/：v2 版本中不可省略；router.go是唯一被beego.Init()自动扫描的路由入口，放在其他位置不会生效 -
models/：非强制，但 ORM 初始化（orm.RegisterModel）通常在此目录下做批量注册；若移走，需手动调用init()函数，否则orm.QueryTable报model not registered
controllers 和 models 目录下的子目录如何组织才不踩坑
Beego 不递归扫描子目录——这是新手最常误判的一点。比如：
- 把控制器放进
controllers/admin/user.go，但没在routers/router.go中显式注册：beego.Router("/admin/user", &controllers.admin.UserController{})→ 路由 404，且无任何警告 - 在
models/user/下建user.go，但models/init.go里没 import_ "myapp/models/user"→ ORM 找不到 struct，Insert时 panicreflect: Call of unexported method - 使用
bee generate model user时未指定-dir=，默认生成到models/根目录；若已有同名子目录，命令会静默覆盖根目录文件，而非合并
static 和 views 目录路径硬编码在框架里，改名等于失效
static/ 和 views/ 是 Beego v2 内置的静态资源与模板根路径，不能通过配置项修改（BConfig.WebConfig.StaticDir 仅支持追加别名路径，不替代默认值）：
- 把
static/改成public/→ CSS/JS 请求全部 404，beego.BConfig.WebConfig.StaticDir默认仍是static，且无法设为空字符串 - 把
views/改成templates/→c.TplName = "index.tpl"会尝试加载views/index.tpl，而非你期望的路径；必须显式设置beego.AddTemplateExt("tpl")并调用beego.SetViewsPath("templates")，且该调用必须在beego.Run()之前 - 模板中引用静态资源必须用相对路径：
<link href="/static/css/app.css">，不能写成<link href="../static/css/app.css">，后者会被 Beego 的静态文件中间件忽略
多环境配置目录不能靠命名区分，得靠 conf/app.conf 的 section 切换
Beego 不支持 conf/dev/app.conf 这类嵌套结构。所有配置必须收拢到 conf/app.conf 单文件内，靠 section 区分：
- 错误做法：建
conf/prod/目录并放app.conf→bee run -d=false仍读取根conf/app.conf，新目录完全无意义 - 正确写法：在
conf/app.conf里定义多个 section：[prod]、[dev]，启动时用bee run -env=prod指定 section；否则默认读取[default] - 注意：section 名称必须全小写，
[PROD]或[Prod]均不识别；且beego.AppConfig.String("mysql.host")在 prod 环境下实际读的是prod.mysql.host，不是prod::mysql.host
真正需要灵活管理的，从来不是目录名本身，而是如何让 bee 工具链和框架初始化流程按你的意图加载——这要求严格对齐约定，而不是试图绕过它。
