当前唯一有效安装命令是 go get -u github.com/beego/beego/v2,v1 已停更;必须启用 go modules、配置 goproxy、配对安装 beego/v2 与 bee/v2,并在代码中使用 github.com/beego/beego/v2 导入路径。

go get -u github.com/beego/beego/v2 是当前唯一有效的安装命令,v1 已停更,任何用 github.com/astaxie/beego 的安装方式都会拉到过期或不兼容版本。
必须加 -u 参数
不加会导致缓存旧版,尤其在 GOPROXY 失效时(比如 Windows 默认配置下),go get 会从本地模块缓存取 v1.12.x 这类早已废弃的版本。
安装前要确保模块环境就绪
-
go env -w GO111MODULE=on—— 强制启用 Go Modules -
go env -w GOPROXY=https://goproxy.cn,direct—— 避免因网络问题拉不到包 - 不在模块路径下执行会报
no required module provides package:先go mod init myapp再重试
bee 工具也要同步装 v2
只装 beego 不装 bee 无法新建项目;只装 v1 的 bee 会创建出 v1 结构但依赖 v2,直接启动失败。
必须配对执行:
go get -u github.com/beego/beego/v2 go get -u github.com/beego/bee/v2
bee 二进制默认生成在 $GOPATH/bin,该路径必须在 $PATH 中,否则终端识别不到 bee 命令。
验证是否真装对了
运行 bee version 能看到输出,但 beego version 会报 command not found —— 这是正常的。v2 没有全局 beego 命令,所有功能都下沉到子包,比如启动入口是 web.Run(),不是 beego.Run()。
真正容易被忽略的是:哪怕 go get 成功、bee new 能建项目、bee run 看似跑起来,只要 main.go 里还 import "github.com/astaxie/beego",就仍是 v1 兼容层在硬扛,实际没用上 v2 的路由性能提升和模块化能力。











