bee命令找不到的根本原因是path与gobin路径不一致，需执行go env -w gobin=$gopath/bin（linux/macos）或go env -w gobin=%userprofile%\go\bin（windows），重启终端后用bee version验证。
bee 命令找不到：PATH 和 GOBIN 不一致
这是 Windows/macOS/Linux 下最常遇到的“安装成功但命令无效”问题。根本原因不是没装上，而是终端找不到 bee 二进制文件。
-
bee默认生成在$GOPATH/bin（Windows 是%USERPROFILE%\go\bin），不是$GOROOT/bin - 执行
go env GOPATH和go env GOBIN，如果两者不一致，go get -u会把bee写到GOBIN路径，而你却只把GOPATH/bin加进了PATH - 推荐统一设为：
go env -w GOBIN=$GOPATH/bin（macOS/Linux）或go env -w GOBIN=%USERPROFILE%\go\bin（Windows） - 改完必须重启终端，再运行
bee version验证
go get 报 no required module provides package
说明当前目录不在 Go Module 环境下，go get 拒绝写入依赖 —— 这是 Go 1.16+ 的默认行为，不是 Beego 的锅。
- 进入项目根目录（或打算初始化项目的空目录），立即执行：
go mod init myapp（模块名可任意，但不能含空格或大写字母） - 再运行：
go get -u github.com/beego/beego/v2和go get -u github.com/beego/bee/v2 - 如果仍报错，检查是否误启用了
GO111MODULE=off：运行go env GO111MODULE，输出应为on或auto；若为off，执行go env -w GO111MODULE=on
beego.Run() 报 undefined：v1/v2 导入路径混用
Beego v2 已彻底拆包，继续用 v1 的导入路径和启动方式，编译器必然报错。
- 检查
main.go中的 import：如果看到"github.com/astaxie/beego"，立刻删掉，换成"github.com/beego/beego/v2/server/web" - 启动函数必须是
web.Run()，不是beego.Run() - 控制器结构体继承也得改：
type MainController struct { web.Controller }，而非beego.Controller - 日志、配置等不再通过主包访问，例如日志要
import "github.com/beego/beego/v2/core/logs"，直接import "github.com/beego/beego/v2"会失败
go mod tidy 后仍 missing go.sum entry
这不是 Beego 特有错误，而是 Go Modules 校验机制发现依赖声明了但校验和缺失 —— 多半因为代理没生效或缓存损坏。
- 先确认代理已启用：
go env -w GOPROXY=https://goproxy.cn,direct - 执行
go clean -modcache清掉本地模块缓存 - 回到项目根目录，再跑一次：
go mod tidy - 如果还失败，检查
go.mod里是否意外引入了 v1 包（如github.com/astaxie/beego），v1 和 v2 不能共存，必须全量替换
/v2，整个项目就起不来。真正卡住人的往往不是功能不会写，而是环境里某处路径、变量或代理状态没对齐。
