Beego v2 是当前唯一可用的主线版本,v1 已停更;安装失败主因是 GOPATH/GOBIN 不匹配、模块代理未启用或混用 v1/v2 导入路径;必须用 go get -u 安装 beego/v2 和 bee/v2,导入路径为 github.com/beego/beego/v2,启动用 web.Run() 且控制器继承 web.Controller。

Beego v2 是当前唯一可用的主线版本,v1 已停更;本地安装失败,90% 出在 GOPATH/GOBIN 配置、模块代理未启用、或混用 v1/v2 导入路径。
go get 安装 beego/v2 和 bee/v2 必须加 -u 参数
不加 -u 会拉取过期缓存版本,尤其 Windows 下 GOPROXY 失效时更明显。执行顺序不能反:
go get -u github.com/beego/beego/v2go get -u github.com/beego/bee/v2
如果提示 no required module provides package,说明当前不在 Go Modules 环境下:先运行 go mod init myapp 初始化模块,再重试。
GOPATH 和 GOBIN 必须配对且加入 PATH
Windows/macOS/Linux 均需确保:
-
GOBIN指向$GOPATH/bin(或显式设置为独立路径) -
$GOPATH/bin必须在系统PATH中,否则bee命令无法识别 - 验证方式:
echo $PATH(macOS/Linux)或echo %PATH%(Windows),确认含bin路径
常见错误:只设了 GOPATH 没设 GOBIN,或设了但没 reload shell 配置(如 source ~/.zshrc)。
必须启用 Go Modules 并配置 GOPROXY
Beego v2 强依赖模块管理,禁用会导致依赖解析失败:
- 启用模块:
go env -w GO111MODULE=on - 配置国内代理:
go env -w GOPROXY=https://goproxy.cn,direct - 若仍卡在某个包(如
golang.org/x/...),可临时补全:go get golang.org/x/crypto@latest
新项目创建后立即报 missing go.sum entry?不是 Beego 问题,是 go.sum 未同步,进项目根目录跑一次 go mod tidy 即可。
bee new 后启动失败:检查 main.go 的 import 和 Run() 调用
最常踩的坑是代码还用着 v1 写法,但实际装的是 v2:
- 旧写法:
import "github.com/astaxie/beego"→ 必须改为import "github.com/beego/beego/v2/server/web" - 旧入口:
beego.Run()→ 已废弃,改用web.Run() - 控制器继承也要同步:
type MainController struct { web.Controller },不是beego.Controller
v2 的核心逻辑已拆到子包,路径和函数名都变了,硬套 v1 文档会直接编译报错。
真正容易被忽略的是:bee 生成的项目默认不含 go.mod 文件,go mod init 必须手动补上,否则后续所有依赖操作都会失效——这不是 Beego 的 bug,是 Go Modules 的强制约定。


















