Beego项目结构依赖约定路径而非强制标准：routers/router.go需被下划线导入以执行init()注册路由，controllers和models必须平铺在根目录，conf/app.conf须为UTF-8无BOM的INI格式且位于根conf下。
Beego 项目目录结构没有强制标准，但官方生成器 bee new 输出的结构就是事实上的规范起点——它不是“可选建议”，而是框架运行逻辑依赖的约定路径。
beego.Router 路由注册失败时，先检查 routers/router.go 是否被正确导入
很多初学者手动删掉或重命名了 routers 目录，结果 beego.Run() 启动后路由完全不生效。这是因为 beego 默认只在 routers/router.go 的 init() 函数里自动加载路由规则，且要求该包被显式导入（哪怕用下划线导入）：
-
main.go中必须包含类似_ "myapp/routers"的导入语句，否则init()不会执行 - 如果把路由文件挪到
controllers/router.go或改名成routes.go，beego.Router调用不会报错，但请求 404 —— 框架根本没看到那些路由 - bee 工具生成的项目默认启用自动路由扫描（
beego.AutoRouter），但一旦你显式调用beego.Router，就必须确保其所在文件被导入并执行
controllers/ 和 models/ 目录下子目录不会被自动识别
beego 不递归扫描 controllers/admin/ 下的 Go 文件。所有控制器必须直接放在 controllers/ 根目录，否则 &controllers.AdminController{} 在路由中引用时会编译失败或 panic：
- 错误写法：
controllers/admin/user.go定义type UserController struct{ beego.Controller }→ 编译报undefined: controllers.AdminController - 正确做法：把
user.go移到controllers/下，结构体名保持首字母大写，且包名为controllers -
models/同理：即使你建了models/user/子目录，orm.RegisterModel(new(user.User))仍需确保user.User类型能被models包外部访问，通常应统一放在models/根目录
conf/app.conf 的位置和格式错误会导致 beego 启动失败或配置未生效
beego.Run() 默认只读取项目根目录下 conf/app.conf，且要求是 INI 格式（不是 JSON/YAML）。常见失效场景：
- 把配置文件放在
config/app.conf或./app.conf→ beego 完全忽略，使用内置默认值 - 文件编码为 UTF-8 with BOM → 解析失败，日志可能只显示
parse conf error，无具体行号 - section 名写成
[dev]但启动时没设runmode = dev→ 对应 section 下的配置项（如mysqlconn）不会被加载 - 路径相关配置（如
viewspath、staticdir）必须写相对路径（如views），不能写绝对路径或带./前缀，否则模板或静态文件 404
实际项目中，最易被忽略的是路由文件的导入方式和 conf/app.conf 的编码问题——这两处不出错，其他结构哪怕稍作调整也能跑起来；一旦出错，现象都是“服务起来但什么请求都 404”，排查方向容易偏移到控制器或中间件上。
