Beego v2安装必须执行go get -u github.com/beego/beego/v2和go get -u github.com/beego/bee/v2,路径含/v2、命令带-u、GOPATH/bin加入PATH、项目先go mod init,缺一不可。

go get 必须加 -u 且指定 /v2 路径
不加 -u 会拉取本地缓存的过期版本,尤其在 Windows 下 GOPROXY 失效时,大概率卡在 v1.12.x;用旧路径 github.com/astaxie/beego 则直接报 no required module provides package 错误。
- 正确命令只有两个,顺序不能反:
go get -u github.com/beego/beego/v2和go get -u github.com/beego/bee/v2 - 如果提示
no required module provides package,说明当前目录没初始化 Go 模块:先运行go mod init myapp,再重试 - v2 不兼容 v1 的导入路径,
github.com/astaxie/beego已彻底废弃,任何残留都会导致编译失败
GOPATH、GOBIN 和 PATH 必须配对生效
bee 二进制默认生成在 $GOPATH/bin,但终端找不到命令,90% 是因为该路径没加进系统 PATH。
- 运行
go env GOPATH查看输出路径,确认$GOPATH/bin下存在bee(Linux/macOS)或bee.exe(Windows) - Mac/Linux 用户把完整路径(如
/Users/xxx/go/bin)加入PATH后,必须新开终端测试bee version - Windows 用户需手动检查系统环境变量,不能只改用户变量,要确保系统级
PATH包含该路径 - 严禁把
bee手动复制到$GOROOT/bin——那是 Go 自身工具的位置,放错会导致后续go命令异常
模块代理和 GO111MODULE 必须提前启用
国内网络下不设代理,go get 极易超时或拉取失败;不启用模块系统,go get 会退化为 GOPATH 模式,与 v2 的模块路径冲突。
- 执行这两条命令(顺序不能反):
go env -w GO111MODULE=on和go env -w GOPROXY=https://goproxy.cn,direct - 这两条命令可在任意目录下运行,不需要先进入项目目录
- 若仍遇到
missing go.sum entry,不是 Beego 的问题,而是 Go Modules 校验未同步:进项目根目录执行go mod tidy - 极少数情况是本地模块缓存损坏,可运行
go clean -modcache清空后重试
main.go 里 import 和启动函数必须严格匹配 v2 规范
哪怕只漏写一个 /v2 或沿用 beego.Run(),都会直接编译失败,不会“勉强运行”。
- 导入路径必须是:
import "github.com/beego/beego/v2/server/web",不是github.com/astaxie/beego - 启动函数必须是:
web.Run(),不是beego.Run() - 控制器结构体继承必须是:
type MainController struct { web.Controller },不是beego.Controller - v2 不支持通过
replace兼容 v1 代码,强行降级只会让构建中断在解析阶段
go env -w 设置完代理后没验证是否生效,以及 $GOPATH/bin 加入 PATH 后没新开终端——这两个动作看似微小,却是绝大多数人反复重装却失败的根源。


















