必须在$GOPATH/src下执行bee new，否则包导入失败、路由未注册、模板不渲染；router.go需显式注册路由；模板路径与数据字段名须严格匹配。
必须在 GOPATH/src 下执行 bee new，否则项目根本跑不起来——这是 90% 新手卡住的第一步。
bee new 必须在 GOPATH/src 目录下运行
Beego 的 bee 工具不认当前路径，它硬编码依赖 Go 传统工作区路径解析逻辑。即使你启用了 go.mod，bee new myapp 仍会按 GOPATH/src/myapp 推导包导入路径。
常见错误现象：
-
main.go中import "myapp/controllers"报错：cannot find package "myapp/controllers" - 控制器写好了，但访问
/返回 404（本质是包没被加载，路由注册失效）
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先运行
go env GOPATH确认输出有效路径（如/home/user/go或C:\Users\xxx\go） - 终端进入
$GOPATH/src（Linux/macOS）或%GOPATH%\src（Windows） - 直接执行
bee new myproject，不要加路径参数（禁止bee new ./myproject或bee new .）
routers/router.go 必须显式注册路由
Beego 不会自动扫描控制器方法，所有路由都得在 routers/router.go 的 init() 函数里手动声明。只写 MainController 结构体、不调用 beego.Router，等于白写。
常见错误现象：
- 浏览器打开
http://localhost:8080显示 Beego 默认欢迎页（说明根路由没被覆盖） - 自定义的
MainController.Get()完全不触发
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确保
routers/router.go中有类似beego.Router("/", &controllers.MainController{})的语句 - 注意传入的是控制器指针（
&controllers.XxxController{}），不是类型名（controllers.XxxController） - 如果只是简单返回字符串，用
beego.Get("/", func(ctx *context.Context) { ctx.WriteString("OK") })更轻量
模板渲染失败的三个硬性条件
用 c.TplName = "index.tpl" 渲染视图时，缺一不可：
-
views/index.tpl文件真实存在（路径区分大小写，比如放在views/admin/下就得写c.TplName = "admin/index.tpl"） -
conf/app.conf中templateleft = "{{"和templateright = "}}"已配置（默认已配好，改过要重启bee run） -
main.go中调用了beego.Run()（仅写http.ListenAndServe不会启用模板引擎）
容易踩的坑：
- 模板里写
{{.Data.Website}}，但实际传的是c.Data["Website"] = "xxx"→ 应写{{.Website}} - 修改了
app.conf但没重启bee run，导致配置不生效
最常被忽略的是：bee 工具和 beego 模块版本不匹配（例如用 v2 的 beego 但装了旧版 bee），会导致路由注册静默失败或模板路径解析异常——务必检查 go list -m github.com/beego/beego/v2 和 bee version 输出是否对齐。
