必须在 $GOPATH/src 下执行 bee new,因其依赖 GOPATH 路径推导 import 包路径;否则 main.go 中如 import "myapp/controllers" 会报错,路由不注册导致 404,模板渲染也因路径不匹配而失败。

必须在 $GOPATH/src 下执行 bee new,否则项目根本跑不起来——这是 90% 新手卡住的第一步。
为什么不能随便建目录再 bee new .
Beego 的 bee 工具依赖 Go 传统的 GOPATH 路径解析逻辑,即使你启用了 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 项目结构和路径约束是刚性的,不是“差不多就行”。bee new 的执行位置、import 路径推导、模板路径匹配,三者必须严格对齐,差一个斜杠或一级目录,就静默失败。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











