beego v2是唯一主线版本，安装需用go get -u github.com/beego/beego/v2和go get -u github.com/beego/bee/v2；路径、导入、启动函数必须严格匹配v2规范，漏写/v2或沿用v1写法将直接编译失败。
Beego v2 是当前唯一可用的主线版本，v1 已停更；安装失败几乎全是环境配置或路径混用导致的，不是框架本身的问题。
go get 安装命令必须带 -u 且指定 v2 路径
v2 的模块路径和 v1 完全不兼容，不能用 go get github.com/astaxie/beego 这类旧写法。正确命令只有两个，顺序不能反：
go get -u github.com/beego/beego/v2go get -u github.com/beego/bee/v2
不加 -u 会拉取本地缓存的过期版本，尤其在 Windows 下 GOPROXY 失效时极易卡在 v1.12.x；如果提示 no required module provides package，说明当前目录没初始化模块，先执行 go mod init myapp 再重试。
GOPATH、GOBIN 和 PATH 必须配对生效
bee 二进制默认生成在 $GOPATH/bin，但终端找不到命令，90% 是因为 $GOPATH/bin 没加进系统 PATH。验证方式：
- 运行
go env GOPATH看输出路径 - 确认该路径下的
bin/子目录存在bee（Linux/macOS）或bee.exe（Windows） - 把完整路径（如
/Users/xxx/go/bin）加入PATH，然后新开终端测试bee version
Mac/Linux 用户注意：不要手动复制 bee 到 $GOROOT/bin，那是 Go 自身工具的位置，放错会导致后续 go 命令异常。
启动项目时 import 路径和入口函数必须匹配 v2
创建项目后运行 bee run 报 undefined: beego.Run，说明代码还在用 v1 写法。v2 已拆分包结构：
- 旧导入：
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 }
这些改不动，go build 或 bee run 都会直接报错，不会“勉强运行”。别指望靠 replace 兼容 v1 代码——v2 不再支持这种降级用法。
go.mod 和 go.sum 校验失败不是 Beego 的锅
新项目 bee new demo 后立刻 bee run 报 missing go.sum entry，这是 Go Modules 的标准行为，不是 Beego 缺依赖。解决只需一步：
- 进入项目根目录，执行
go mod tidy
如果仍失败，大概率是代理没生效：执行 go env -w GOPROXY=https://goproxy.cn,direct；极少数情况是本地模块缓存损坏，可运行 go clean -modcache 清空后再试。
最常被忽略的是：v2 的所有路径、导入、函数调用都强制带 /v2，漏一个斜杠或拼错子包名（比如写成 server/http 而非 server/web），编译就断在第一行。别抄旧教程，认准官网文档域名 beego.me 上标注 v2 的页面。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
