Beego v2 安装需 Go ≥ 1.16、启用 GO111MODULE=on、配置 GOPROXY，执行 go get -u github.com/beego/beego/v2 和 github.com/beego/bee/v2，bee 二进制须加入 PATH。
Beego 框架安装本身不强制要求提前配置 GOPATH（Go 1.13+ 默认启用模块模式），但实际执行 go get 或 bee 命令时，若环境变量或网络策略没对齐，90% 的失败都卡在这几步。
Go 版本与模块模式必须确认
Beego v2（当前主流版本）要求 Go ≥ 1.16；低于该版本会因模块兼容性直接报错，比如 unknown revision 或 cannot find module providing package。运行以下命令验证：
go version go env GO111MODULE
若输出中 GO111MODULE 是 off，需手动开启：
go env -w GO111MODULE=on-
go env -w GOPROXY=https://goproxy.cn,direct（国内推荐，避免 GitHub 超时）
bee 工具二进制路径必须在 $PATH 中
bee 安装后生成的是可执行文件，不是源码包——它默认落在 $GOPATH/bin（Go 1.13+ 也可能落在 $GOROOT/bin 或 $HOME/go/bin）。如果执行 bee version 提示 command not found，说明路径没生效：
- 检查
go env GOPATH输出的路径下是否存在bin/bee - 把该
bin目录加进 shell 的PATH（如export PATH=$PATH:$GOPATH/bin），并source ~/.bashrc或source ~/.zshrc - Windows 用户注意：PowerShell 和 CMD 的环境变量设置方式不同，
bee.exe必须能被全局调用
git 和 SSL 验证容易被忽略
go get 内部依赖 git 克隆仓库。常见报错如：
fatal: unable to access 'https://github.com/astaxie/beego/': SSL certificate problem
这不是 Beego 的问题，而是系统 CA 证书缺失或代理干扰。临时解决（仅限开发机）：
-
git config --global http.sslVerify false（不推荐长期使用） - 更稳妥的方式是配置代理：
git config --global https.proxy http://127.0.0.1:7890（对应你本地代理端口） - macOS 若用 Homebrew 安装 git，可尝试
brew install ca-certificates后重试
真正卡住安装的，往往不是 Beego 本身，而是 go mod 拉依赖时某一个间接包（比如 golang.org/x/...）被墙，或 bee 编译时找不到 go 的 embed 支持（Go 1.16+ 才有）。别急着重装，先看 go env 输出里 GOPROXY 和 GO111MODULE 是否真生效——这是最常被跳过的验证动作。
