beego框架和bee命令行工具必须分开安装：先执行go get github.com/beego/beego/v2安装框架，再执行go install github.com/beego/bee/v2@latest安装CLI工具，且需确保GO111MODULE=on、GOPROXY已配置，并在项目根目录运行bee run。
beego 和 bee 命令行工具必须分开安装
很多人以为 go get github.com/beego/beego/v2 就能直接用 bee 命令，其实不行。bee 是独立的 CLI 工具，不随框架自动安装。漏掉这一步，后续执行 bee new 会报 command not found。
正确顺序是：
- 先装框架：
go get github.com/beego/beego/v2 - 再装工具：
go install github.com/beego/bee/v2@latest（注意：v2 推荐用go install而非旧式go get -u，后者在 Go 1.21+ 已弃用） - 确认
$GOBIN或$GOPATH/bin在系统PATH中（Linux/macOS 检查echo $PATH；Windows 检查环境变量） - 运行
bee version验证是否可执行
GO111MODULE=on 和 GOPROXY 必须提前设好
Beego v2 默认基于 Go Modules，如果没开启模块支持，go get 会静默失败或拉取错误版本（比如误装 v1）。常见现象是：bee run 启动时报错 cannot find package "github.com/beego/beego/v2"，但 go list -m all 里又看不到它。
执行这两条命令即可解决：
go env -w GO111MODULE=on-
go env -w GOPROXY=https://goproxy.cn,direct（国内推荐；如在外网可换为https://proxy.golang.org,direct）
设置后无需重启终端，但已有项目若已生成 go.mod，建议删掉重跑 go mod init + go mod tidy。
bee new 创建项目后必须 go mod tidy
用 bee new myapp 生成的项目默认带 go.mod，但依赖声明往往不全——尤其是 Beego v2 的子模块（如 server/web、config）可能未显式 require。直接 bee run 容易报 import path not found 或编译失败。
进入项目根目录后，务必执行：
-
go mod tidy（自动补全缺失依赖并清理未使用项） - 检查输出中是否包含
github.com/beego/beego/v2及其子模块 - 若提示
require github.com/beego/beego/v2: version "v2.x.y" invalid，说明本地缓存损坏，可加-replace临时修复：go mod edit -replace github.com/beego/beego/v2=github.com/beego/beego/v2@v2.1.0
bee run 报错 “no required module provides package” 怎么办
这是最典型的路径陷阱：你没在项目根目录下运行 bee run，而是在 src/ 或 controllers/ 子目录里执行的。bee 依赖当前目录下的 go.mod 和 main.go，路径错一个层级就会找不到入口包。
确认方式很简单：
- 执行
pwd（Linux/macOS）或cd（Windows），看是否在项目顶层（含conf/、controllers/、main.go的目录） - 执行
ls main.go go.mod，两个文件必须同时存在 - 如果项目是从旧版迁移来的，检查
main.go顶部的 module 声明是否匹配目录名，例如：module myapp→ 项目目录名必须为myapp，否则go build会失败
真正麻烦的不是命令记不住，而是 go mod 的隐式行为和 bee 的路径敏感性叠加后，错误信息根本不指明问题在哪。多花十秒确认当前工作目录，比反复重装快得多。
