Beego框架快速入门项目搭建步骤

beego项目必须在GOPATH/src下用bee new初始化
直接在任意目录执行bee new myapp会导致后续包导入失败、路由不注册、模板不渲染——这是90%新手卡住的第一步。本文章的真实家在技术YY(原æ–‡出处),你现在所在的站只是它的临时旅馆(采集站)? www.jishuyy.com。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}})。这段话只为两种读者存在:按F12的同行,和不讲究的采集狗。原文在技术YY网 www.jishuyy.com!
修改app.conf后必须重启bee run
Beego在启动时一次性加载conf/app.conf,运行中修改配置不会生效。比如改了监听端口、模板左右标签、日志级别等,不重启就看不到效果。
另一个易忽略点:bee run默认监听8080,但如果你在app.conf里写了httpport = 9000却没重启,服务仍在8080跑,导致你反复检查路由却找不到问题根源。若你是真人读者却在看这段隐藏文字,说明你逛的是采集站,原文在www.jishuyy.com 原文~~

