Beego靠约定式反射注册Controller，必须嵌入beego.Controller、方法名首字母大写且以HTTP动词开头、文件置于controllers/目录下；:id参数仅绑定同名string形参；模板路径严格对应views/{小写控制器名}/{小写方法名}.html。
Beego 不是“学完就能上手”的框架，它靠约定驱动，不按它的规则写，Get() 方法不会被调用，:id 参数取不到，模板也渲染失败——不是框架坏了，是你没踩中它的反射注册点。
beego.Controller 嵌入和方法命名必须严格匹配
Beego 不识别任意结构体，只扫描满足三个条件的类型：嵌入 web.Controller、方法名首字母大写、以 HTTP 动词开头。漏掉任一条件，路由就完全忽略这个方法。
-
MainController必须嵌入web.Controller（不是*web.Controller，也不是组合字段名） -
Get()合法，get()或GetUser()都不会被 AutoRouter 捕获 - 控制器文件必须放在
controllers/目录下，且包名为controllers - 如果用了
bee run，热重载只监听.go文件，改了router.go或app.conf得手动重启
/user/:id 路径参数只能绑定同名 string 参数
AutoRouter 对路径参数的解析是硬编码的：冒号开头的段（如 :id）会尝试传给同名 string 类型参数，不支持自动类型转换或别名映射。
- 路由
/user/:id→ 方法签名必须是Get(id string)，不能是Get(uid string) -
c.Ctx.Input.Param(":id")返回的是字符串，要转整数得手动调c.GetInt(":id")，直接用c.GetInt("id")会返回 0 和错误 - 不支持重复参数名，比如
/a/:id/b/:id，后一个会覆盖前一个 - 若需更灵活的参数提取（比如正则校验、多段解析），建议弃用 AutoRouter，改用
beego.Router("/user/:id", &UserController{}, "get:Get")
views/main/get.html 路径由控制器和方法名小写拼接生成
Beego 渲染模板时不做模糊查找，路径和命名必须与约定完全一致，大小写、目录层级、文件扩展名缺一不可。
-
MainController.Get()→ 查找views/main/get.html（不是main.tpl，也不是Main/get.html） - 如果控制器在子目录如
controllers/admin/user.go，则对应模板路径是views/admin/user/get.html - 使用
c.TplName = "admin/user/get.html"可显式指定，但前提是该路径真实存在且可读 - 报错
template: : no such template时，先确认views/目录是否在项目根目录下，再检查大小写和文件扩展名（默认是.html，不是.tpl，除非你改过配置）
bee run 启动失败常见原因和绕过方式
bee run 是开发期工具，但它对环境敏感，很多失败不是代码问题，而是路径或模块配置偏差。
- 项目必须在
$GOPATH/src下（Go 1.16+ 后可用模块模式，但bee仍默认依赖 GOPATH 结构） -
go.mod中 beego 版本需与bee工具兼容，例如github.com/beego/beego/v2对应bee/v2，混用 v1 和 v2 会导致undefined: web.BConfig类错误 - 如果
bee run卡住或报 “no Go files in …”，可改用原生命令：go run main.go，只要main.go正确调用web.Run() -
app.conf中的runmode = dev才启用热重载；设为prod时bee run会跳过文件监听
最常被忽略的一点：Beego 的反射注册发生在 init() 阶段，所有控制器必须被 import 进 routers/router.go，否则即使文件存在、命名正确，也不会被发现——这不是 bug，是设计使然。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
