Beego v2是当前唯一主线版本,v1已停更;安装需执行go get -u github.com/beego/beego/v2和go get -u github.com/beego/bee/v2,路径必须含/v2且顺序不可颠倒,漏写/v2或沿用v1写法将直接编译失败。

Beego v2 是当前唯一可用的主线版本,v1 已停更;所有安装失败几乎都源于环境配置错误或混用 v1/v2 路径,不是框架本身的问题。
go get 安装命令必须带 -u 且路径精确到 /v2
v2 的模块路径和 v1 完全不兼容,旧写法 go get github.com/astaxie/beego 会拉取已废弃的 v1,直接导致后续编译报错。正确命令只有两个,顺序不能反:
go get -u github.com/beego/beego/v2go get -u github.com/beego/bee/v2
不加 -u 会拉取本地缓存的过期版本(尤其 Windows 下 GOPROXY 失效时易卡在 v1.12.x);如果提示 no required module provides package,说明当前目录没初始化 Go 模块,先执行 go mod init myapp 再重试。
$GOPATH/bin 必须加入系统 PATH 才能识别 bee 命令
bee 二进制默认生成在 $GOPATH/bin,但终端找不到命令,90% 是因为该路径没加进系统 PATH。验证方式:
- 运行
go env GOPATH看输出路径 - 确认该路径下存在
bin/bee(Linux/macOS)或bin/bee.exe(Windows) - 把完整路径(如
/Users/xxx/go/bin)加入PATH,然后新开终端运行bee version测试
Mac/Linux 用户注意:不要手动复制 bee 到 $GOROOT/bin,那是 Go 自身工具的位置,放错会导致后续 go 命令异常。
bee new 后立即 go mod tidy,否则 go.sum 校验失败
执行 bee new demo 创建项目后,立刻 bee run 报 missing go.sum entry,这是 Go Modules 的标准行为,不是 Beego 缺依赖。解决只需一步:
- 进入项目根目录,执行
go mod tidy
若仍失败,大概率是代理未生效:运行 go env -w GOPROXY=https://goproxy.cn,direct;极少数情况是本地模块缓存损坏,可运行 go clean -modcache 清空后再试。
main.go 里 import 和 web.Run() 必须匹配 v2 规范
启动项目时报 undefined: beego.Run,说明代码还在用 v1 写法。v2 已拆分包结构:
- 旧导入:
import "github.com/astaxie/beego"→ 必须改为import "github.com/beego/beego/v2/server/web" - 旧启动:
beego.Run()→ 必须改为web.Run() - 控制器继承:
type MainController struct { beego.Controller }→ 改为type MainController struct { web.Controller }
这些改不动,go build 或 bee run 都会直接报错,不会“勉强运行”。别指望靠 replace 兼容 v1 代码——v2 不再支持这种降级用法。
最容易被忽略的是:v2 的子包路径(比如 server/web、core/logs)必须显式写全,漏一个斜杠或拼错字母都会导致编译失败,且错误信息往往不指向具体位置,得逐行核对 import 和调用链。


















