Beego v2 是当前唯一可正常安装并用于新项目的版本,v1 已停更;安装失败主因是 GOPATH/GOBIN 未配对、GOPROXY 未启用或混用 v1/v2 路径;go get 必须加 -u 参数,且需先 go mod init 再执行;bee 命令需确保 $GOPATH/bin 在 PATH 中;启动报 undefined: beego.Run 说明仍用 v1 写法,v2 应改用 import "github.com/beego/beego/v2/server/web" 并调用 web.Run()。

Beego v2 是当前唯一可正常安装并用于新项目的版本,v1 已停更且与 Go Modules 兼容性差;本地安装失败,90% 情况是 GOPATH/GOBIN 未配对、GOPROXY 未启用,或混用了 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 mod init myapp 初始化,再重试。
bee 二进制找不到命令?检查 $PATH 是否包含 $GOPATH/bin
bee 安装后默认生成在 $GOPATH/bin(Mac/Linux)或 %GOPATH%\bin(Windows),该路径必须在系统 PATH 中,否则终端无法识别 bee 命令。
- Mac/Linux:确认
echo $PATH输出含$GOPATH/bin,否则在~/.zshrc或~/.bash_profile中追加export PATH=$PATH:$GOPATH/bin - Windows:检查系统环境变量
PATH是否包含%GOPATH%\bin - 验证:终端直接输入
bee version,有输出即成功
bee new 创建项目后 go mod tidy 报 missing go.sum entry
这不是 Beego 问题,而是 Go Modules 的校验机制触发:项目初始化后 go.mod 已声明依赖,但 go.sum 还未同步。
- 进入项目根目录,立即运行
go mod tidy - 若仍失败,大概率是
GOPROXY未生效:执行go env -w GOPROXY=https://goproxy.cn,direct - 极少数情况是本地模块缓存损坏,可清空:
go clean -modcache,再go mod tidy
main.go 启动报 undefined: beego.Run?你还在用 v1 的写法
v2 已废弃 beego.Run(),核心入口函数拆到子包,控制器继承也变了。
- 旧写法(v1):
import "github.com/astaxie/beego"+beego.Run()→ 必须删掉 - 新写法(v2):
import "github.com/beego/beego/v2/server/web"+web.Run() - 控制器结构体也要改:
type MainController struct { web.Controller },不是beego.Controller
最容易被忽略的是:即使 bee version 显示正常,beego version 报 command not found,说明你根本没正确安装 v2 的运行时依赖——它不提供全局 beego 命令,只通过 web.Run() 在代码中调用。


















