Beego v2 是当前唯一推荐版本，v1 已停更；安装需配对 GOPATH/GOBIN、启用模块代理、执行 go install github.com/beego/bee/v2@latest 和自动拉取 github.com/beego/beego/v2，导入路径必须为 github.com/beego/beego/v2/server/web，启动用 web.Run() 且控制器继承 web.Controller。
Beego v2 是当前唯一值得投入的版本，v1 已停止维护，直接装 github.com/beego/beego/v2，别碰 github.com/astaxie/beego。
bee 命令找不到：PATH 没配对
安装完 bee 后执行 bee version 报 “command not found”，本质是系统找不到可执行文件。Go 1.16+ 默认使用模块模式，go install 会把二进制放到 $GOPATH/bin（不是 $GOROOT/bin），这个路径必须在 PATH 里。
- 查路径：
go env GOPATH，然后确认$GOPATH/bin是否存在bee（Windows 是bee.exe） - Linux/macOS：在
~/.bashrc或~/.zshrc末尾加export PATH=$PATH:$GOPATH/bin，再source一次 - Windows：用“系统属性 → 高级 → 环境变量”，在用户或系统
PATH中新增%GOPATH%\bin，重启终端 - 验证：
echo $PATH（macOS/Linux）或echo %PATH%（Windows）看是否包含该路径
go get 失败：代理和模块模式没开
常见报错如 unrecognized import path "golang.org/x/net/http2" 或卡在 Fetching ...，根本原因是国内直连 golang.org 不稳定，且 Go 模块未启用。
- 必须开启模块：
go env -w GO111MODULE=on - 必须设代理：
go env -w GOPROXY=https://goproxy.cn,direct - 如果仍失败，先清理缓存：
go clean -modcache，再重试go install github.com/beego/bee/v2@latest - 注意：Beego v2 的安装命令是
go install github.com/beego/bee/v2@latest，不是go get；框架本身不用单独go get，项目里go mod init后自动拉取
新建项目后 run 不起来：main.go 路径或依赖不全
bee new myapp 成功后执行 bee run 报 cannot find package 或 undefined: beego，通常不是 Bee 问题，而是项目结构或模块初始化出错。
- 确保在项目根目录（含
go.mod文件）下运行bee run，不是在src或controllers子目录 - 首次运行前先执行
go mod tidy，补全go.mod中缺失的beego/v2和子模块（如server/web） - v2 的
main.go必须显式导入github.com/beego/beego/v2/server/web，不能只写import "beego" - 检查
go.mod第一行是否为module myapp（名称要与项目目录一致），否则go build会找不到入口
最易被忽略的是 v2 的导入路径拆分——web.Run() 来自 github.com/beego/beego/v2/server/web，logs.Info() 来自 github.com/beego/beego/v2/core/logs，混用 v1 路径或省略子包名，编译直接失败。
