beego项目必须在gopath/src下用bee new初始化，否则包导入失败、路由未注册、模板不渲染；router.go需显式注册路由；模板路径和数据字段名须严格匹配。
Beego 项目不是“新建目录就能跑”，必须在 GOPATH/src 下用 bee new 初始化，否则 main.go 找不到包、路由注册失败、模板加载报错——这是 90% 新手卡住的第一步。
beego 项目必须在 GOPATH/src 下创建
Beego 的 bee 工具依赖 Go 的传统工作区模型（非纯 go mod 模式），即使项目启用了 go.mod，bee 仍会按 GOPATH/src/xxx 路径解析包导入路径。常见错误现象：
-
cannot find package "myproject/controllers"—— 因为main.go中 import 是"myproject/controllers"，而 Go 只在GOPATH/src下搜索该路径 -
bee run启动后访问/返回 404 —— 路由未注册，本质是控制器包没被正确加载
实操建议：
- 确认
go env GOPATH输出有效路径（如/home/user/go） - 进入
$GOPATH/src，再执行bee new myapp - 不要手动
mkdir myapp && cd myapp && bee new .—— 这会破坏包路径推导
router.go 必须显式调用 beego.Router 或 beego.Get
Beego 不会自动扫描控制器方法，所有路由都需在 routers/router.go 的 init() 函数中声明。只写控制器结构体、不注册路由，等于没写。
常见错误现象：
- 浏览器打开
http://localhost:8080显示 Beego 默认欢迎页（说明路由没覆盖根路径） - 自定义的
MainController.Get()完全不触发
实操建议：
- 确保
routers/router.go中有类似beego.Router("/", &controllers.MainController{}) - 若想只响应 GET，用
beego.Get("/", func(ctx *context.Context) { ctx.WriteString("OK") })更轻量 - 注意：参数是控制器指针（
&controllers.XxxController{}），不是类型（controllers.XxxController）
模板渲染需同时满足三个条件
用 c.TplName = "index.tpl" 渲染视图时，缺一不可：
-
views/index.tpl文件存在（路径区分大小写） -
conf/app.conf中设置了templateleft = "{{"和templateright = "}}"（默认已配好） -
main.go中调用了beego.Run()（而非仅http.ListenAndServe）—— 否则模板引擎不启用
容易踩的坑：
- 把
index.tpl放在views/admin/下，却写c.TplName = "index.tpl"（应写"admin/index.tpl"） - 模板里写
{{.Data.Website}}，但实际传的是c.Data["Website"] = "xxx"（应写{{.Website}}） - 修改了
app.conf但没重启bee run，导致配置未生效
bee run 启动失败时先看 conf/app.conf 和日志位置
bee run 报错常被误认为代码问题，其实多数源于配置或路径。典型错误信息和对应动作：
-
open conf/app.conf: no such file or directory—— 说明当前不在项目根目录（即含conf/、controllers/的目录），用pwd确认 -
panic: reflect: Call using nil *—— 控制器方法签名错误，比如func (c MainController) Get()少了指针接收器（应为func (c *MainController) Get()） - 终端无输出、浏览器空白 —— 检查
conf/app.conf中httpport是否被占用，或加logs = true开启日志查看具体卡点
真正麻烦的从来不是语法，而是 bee 隐式依赖的路径约定和初始化顺序——它不报错，只是静默跳过你认为“应该生效”的部分。
