Beego v2安装必须用go get -u github.com/beego/beego/v2和go get -u github.com/beego/bee/v2，漏写/v2、不加-u或GOPATH/bin未加入PATH均会导致失败。
go get 安装 beego/v2 和 bee/v2 必须带 -u 且路径含 /v2
不加 -u 会拉取本地缓存的过期版本，尤其在 Windows 下 GOPROXY 失效时，极易卡在 v1.12.x；漏写 /v2 或沿用 github.com/astaxie/beego 这类旧路径，直接导致编译失败。正确命令只有两个，顺序不能反：
go get -u github.com/beego/beego/v2go get -u github.com/beego/bee/v2
如果提示 no required module provides package，说明当前目录没初始化 Go 模块，先执行 go mod init myapp 再重试。
bee 命令找不到？90% 是 $GOPATH/bin 没进 PATH
bee 二进制默认生成在 $GOPATH/bin（Linux/macOS）或 %USERPROFILE%\go\bin（Windows），但终端识别不到，几乎全是环境变量没配对导致的。验证方式：
- 运行
go env GOPATH看输出路径 - 确认该路径下存在
bee（macOS/Linux）或bee.exe（Windows） - 把完整路径（如
/Users/xxx/go/bin）加入系统PATH，然后新开终端测试bee version
Mac/Linux 用户注意：不要手动复制 bee 到 $GOROOT/bin，那是 Go 自身工具的位置，放错会导致后续 go 命令异常。
bee run 报 undefined: beego.Run？这是 v1/v2 混用的典型症状
v2 已彻底拆分包结构，所有 v1 写法都会直接报错，不会“勉强运行”。必须同步修改三处：
- 导入路径：从
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 }
别指望靠 replace 兼容 v1 代码——v2 不再支持这种降级用法。改不动，go build 或 bee run 都会立刻失败。
bee new 后立即 bee run 报 missing go.sum entry
这不是 Beego 的问题，是 Go Modules 的标准校验行为：新项目 go.mod 里声明了依赖，但 go.sum 还没同步。解决只需一步：
- 进入项目根目录，执行
go mod tidy
若仍失败，大概率是代理没生效：go env -w GOPROXY=https://goproxy.cn,direct；极少数情况是本地模块缓存损坏，可运行 go clean -modcache 清空后再试。
Beego v2 是当前唯一主线版本，v1 已停更；所有安装失败、命令报错、启动崩溃，基本都卡在路径、环境变量、模块代理这三点上，而不是框架本身不可用。真正容易被忽略的是：v2 的子包路径（如 server/web）必须显式写出，少一个层级就编译不过。
