beego controller 靠约定式反射自动注册，需嵌入 beego.controller、方法名首字母大写且以 http 动词开头、文件置于 controllers/ 目录下；路由参数用 :id 形式绑定到同名 string 参数；模板路径为 views/{小写控制器名}/{小写方法名}.html；热重载仅监听 .go 文件且需 dev 模式。
Beego 的 Controller 不是靠“继承”或“定义接口”来工作的，而是靠约定式反射自动注册——你写个结构体、嵌入 beego.Controller、再加几个以 Get/Post 开头的方法，框架就认得它。
为什么新建的 Controller 方法不被路由识别？
最常见原因是没按 Beego 的命名和嵌入规范来。Beego 不扫描任意 struct，只认“嵌入了 beego.Controller 且方法名首字母大写 + 符合 HTTP 动词前缀”的类型。
- 必须嵌入
beego.Controller（不是组合、不是指针、不能跳过） - 方法名必须是
Get、Post、Put、Delete等，且首字母大写（get()不行，Get()才行） - 控制器文件需放在
controllers/目录下，且包名是controllers - 路由没显式注册时，Beego 默认启用
AutoRouter，但只对controllers/下的公开类型生效
示例正确写法：
package controllers
import "github.com/beego/beego/v2/server/web"
type MainController struct {
web.Controller
}
func (c *MainController) Get() {
c.Ctx.WriteString("hello")
}
如何让 Beego 路由匹配带参数的 URL（比如 /user/123）？
Beego 的 AutoRouter 默认支持路径参数，但规则固定：路径段用冒号开头（如 :id），对应方法参数必须叫 id，且类型为 string；如果想转成 int，得自己调 c.Ctx.Input.Param(":id") 再转换。
-
/user/:id→ 自动传参到Get(id string)方法（仅限Get等动词方法，且参数名必须和路径中一致） - 不支持多个同名参数（如
/a/:id/b/:id），会覆盖 - 若用
NSRouter或手动Get("/user/:id", ...)，参数提取逻辑一样，但更可控 - 注意：
:id是字符串，c.GetInt(":id")才能转 int，直接c.GetInt("id")会失败
模板渲染报错 template: ...: no such template 怎么办？
Beego 查找模板的路径和命名强依赖目录结构和控制器名，不是“随便放个 HTML 就能用”。默认规则是：views/{控制器名小写}/{方法名小写}.html。
-
MainController.Get()→ 查找views/main/get.html - 路径分隔符是斜杠，不是点号；大小写敏感；扩展名必须是
.html（除非改了beego.TemplateExt） - 模板里用
{{.}}访问控制器的Data字段（map[string]interface{}），不是整个 controller 实例 - 如果用了
c.TplName = "xxx.html"，那路径就按你写的走，但依然要确保文件存在且可读
为什么 bee run 启动后修改代码没热重载？
bee run 热重载只监听 .go 文件变化，且只在 app.conf 中 runmode = dev 且 autorender = true 时才生效；但它不监听 views/ 或 static/ 变化。
- 改了 HTML 模板？需要手动刷新浏览器，或者配第三方工具（如
browser-sync）监听views/ - 改了
conf/app.conf？bee run不会重载配置，必须重启 - 改了
models/里的结构体？会触发重编译，但数据库迁移得手动跑bee migrate - Windows 下杀进程有时残留，导致端口占用，
bee run报address already in use，得手动taskkill /f /im bee.exe
真正容易被忽略的是：Beego 的 Controller 嵌入方式、参数绑定规则、模板路径推导这三处，全靠约定，没有错误提示，出问题只会静默失败或 404。写完别急着测接口，先看一眼日志里有没有 Registered controller 和 Loaded templates 这类线索。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
