Beego是面向已有Go基础、需快速构建Web服务的开发者的框架，要求理解net/http模型，项目须在GOPATH/src下初始化，路由需手动注册，模板渲染依赖文件路径、配置及beego.Run()，且其模块可独立复用。
Beego 不是“学 Go 的入门路径”，而是适合已有 Go 基础、想快速落地 Web 服务的开发者用的框架。它不掩盖 Go 的底层机制，但会帮你跳过 HTTP Server 手写、路由分发、模板绑定等重复劳动——前提是，你得先理解 net/http 的基本模型（比如 http.Handler、http.ServeMux、context.Context）。
beego 项目必须在 GOPATH/src 下初始化，否则 import 肯定失败
这是最常卡住新手的第一关：哪怕你启用了 go.mod，bee new 仍按传统 GOPATH 模式推导包路径。main.go 里写的 import "myapp/controllers"，Go 只会在 $GOPATH/src/myapp/controllers 找。
- 执行
go env GOPATH确认路径有效（如/home/user/go） - cd 进入
$GOPATH/src，再运行bee new myapp - 不要在任意目录下
mkdir myapp && cd myapp && bee new .—— 这会让包名变成./controllers，导致编译报cannot find package "myapp/controllers" - 如果已出错，删掉整个项目目录，回到
$GOPATH/src重来
路由不生效？大概率是没显式注册或指针传错了
Beego 不扫描控制器方法，所有路由都靠你在 routers/router.go 里手动调用 beego.Router 或 beego.Get 注册。只写 MainController.Get() 方法，不注册，等于没写。
- 检查
routers/router.go的init()函数里是否有类似beego.Router("/", &controllers.MainController{}) - 注意是
&controllers.MainController{}（取地址），不是controllers.MainController{}（值类型） - 若只想响应 GET，用
beego.Get("/", func(ctx *context.Context) { ctx.WriteString("OK") })更轻量，也绕过控制器生命周期 - 访问
/却看到 Beego 默认欢迎页？说明根路由没被覆盖，beego.Router("/", ...)没生效或位置被后面规则覆盖
模板渲染失败的三个硬性条件缺一不可
c.TplName = "index.tpl" 能跑起来，需要同时满足：
立即学习“go语言免费学习笔记（深入）”；
-
views/index.tpl文件真实存在（路径大小写敏感，Views/或views/Index.tpl都不行） -
conf/app.conf中templateleft = "{{"和templateright = "}}"已配置（默认有，但改过就可能被删） -
main.go最后一行是beego.Run()—— 如果替换成http.ListenAndServe，模板引擎根本不会启动 - 传数据时写
c.Data["Website"] = "beego.dev"，模板里就得用{{.Website}}，不是{{.Data.Website}}
真正容易被忽略的是：Beego 的模块化设计（比如 cache、logs、config）可以脱离 Web 服务单独使用。你完全可以在一个 CLI 工具里只 import github.com/beego/beego/v2/core/logs 来做结构化日志，不必启动整个框架。这种“乐高式”用法，才是它比纯封装框架更值得深入的地方。
