Beego项目必须在GOPATH/src下执行bee new初始化,否则包导入失败、路由不注册、模板不渲染;router.go需显式注册路由;模板路径与数据字段名须严格匹配。

beego项目必须在GOPATH/src下用bee new初始化
直接在任意目录执行bee new myapp会导致后续包导入失败、路由不注册、模板不渲染——这是90%新手卡住的第一步。beego的bee工具依赖Go的传统工作区模型,即使项目启用了go.mod,它仍按GOPATH/src/xxx路径解析导入路径。
常见错误现象:cannot find package "myapp/controllers",本质是main.go中写的import "myapp/controllers",而Go只在$GOPATH/src下搜索该路径。
- 运行
go env GOPATH确认有效路径(如/home/user/go) - 进入
$GOPATH/src,再执行bee new myapp - 禁止手动
mkdir myapp && cd myapp && bee new .——这会破坏包路径推导
routers/router.go必须显式注册路由
Beego不会自动扫描控制器方法,所有HTTP端点都需在routers/router.go的init()函数中声明。只写MainController结构体、不注册路由,等于没写。
常见错误现象:bee run启动后访问/返回404;自定义的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)——否则模板引擎根本不启用
容易踩的坑:c.TplName = "index.tpl"但模板实际放在views/admin/下(应写"admin/index.tpl");模板里写{{.Data.Website}}但传的是c.Data["Website"] = "xxx"(应写{{.Website}})。
修改app.conf后必须重启bee run
Beego在启动时一次性加载conf/app.conf,运行中修改配置不会生效。比如改了监听端口、模板左右标签、日志级别等,不重启就看不到效果。
另一个易忽略点:bee run默认监听8080,但如果你在app.conf里写了httpport = 9000却没重启,服务仍在8080跑,导致你反复检查路由却找不到问题根源。


















