Beego项目必须在GOPATH/src下执行bee new初始化，否则包导入失败、路由未注册、模板不渲染；router.go需显式注册路由；模板路径和数据字段名须严格匹配。
必须在 GOPATH/src 下执行 bee new，否则项目根本跑不起来——这是 90% 新手卡住的第一步。
beego 项目不能随便建目录再 bee new .
Beego 的 bee 工具依赖 Go 的传统工作区路径解析逻辑，即使你启用了 go.mod，它仍会按 GOPATH/src/xxx 推导包导入路径。手动在任意位置 mkdir myapp && cd myapp && bee new . 会导致：
-
main.go中的import "myapp/controllers"找不到包（cannot find package "myapp/controllers"） - 控制器结构体写对了，但
bee run启动后访问/返回 404（路由未注册，本质是包没被加载）
实操建议：
- 运行
go env GOPATH确认输出有效路径（如/home/user/go或C:\Users\xxx\go） - 终端进入
$GOPATH/src目录（Linux/macOS）或%GOPATH%\src（Windows） - 直接执行
bee new myproject，不要加路径参数
routers/router.go 必须显式注册路由
Beego 不会自动扫描控制器方法，所有路由都得在 routers/router.go 的 init() 函数里手动声明。只写 MainController 结构体、不调用 beego.Router，等于白写。
常见错误现象：
- 浏览器打开
http://localhost:8080显示 Beego 默认欢迎页（说明根路由没被覆盖） - 自定义的
MainController.Get()完全不触发
实操建议：
- 确保
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，导致配置不生效
最常被忽略的是：Beego 的项目结构和路径约定是强约束，不是“能编译就对”。哪怕只错一个斜杠、少一个 &、模板路径多一层目录，都会静默失败——它不会报错，只会返回 404 或空白页。
