bee命令找不到的本质是$gopath/bin未加入path环境变量，需将其与$goroot/bin一并添加至系统path，并刷新终端；同时须配置go111module=on和goproxy=https://goproxy.cn以确保bee run正常执行。
bee 命令找不到，本质是 $GOPATH/bin 没进 PATH
安装完 bee 后执行 bee version 报错“不是内部或外部命令”，说明系统根本没找到这个可执行文件。它默认生成在 $GOPATH/bin 目录下（比如 Windows 是 %USERPROFILE%\go\bin，macOS/Linux 是 $HOME/go/bin），但该路径未被加入系统 PATH 环境变量。
关键点不是“装没装上”，而是“找不找得到”。go get -u github.com/beego/bee/v2 成功后，二进制文件已落盘，只是 shell 不知道去哪翻。
- 先确认
bee实际位置：go env GOPATH查出 GOPATH，然后检查$GOPATH/bin/bee（Windows 下是bee.exe）是否存在 - Windows：在“系统属性 → 高级 → 环境变量”中，编辑“系统变量”里的
Path，新增一行：%GOPATH%\bin（注意别写死路径，用变量更稳妥） - macOS/Linux：在
~/.zshrc或~/.bash_profile末尾追加：export PATH=$PATH:$GOPATH/bin，然后运行source ~/.zshrc - 改完必须新开终端——旧终端的环境变量不会自动刷新
GOROOT/bin 也要加进 PATH，否则 go 工具链会断
bee 依赖 go 命令本身，而 go 可执行文件在 $GOROOT/bin。如果只加了 $GOPATH/bin 却漏掉 $GOROOT/bin，可能触发连锁报错，比如 go: command not found 或 bee run 中间卡在编译阶段。
常见错误现象：bee version 能跑，但 bee run 报错说找不到 go 或 go build 失败。
- 查
GOROOT：运行go env GOROOT - Windows：同样在系统环境变量
Path中补上%GOROOT%\bin - macOS/Linux：在 shell 配置文件里补一句：
export PATH=$PATH:$GOROOT/bin - 验证是否生效：
which go（macOS/Linux）或where go（Windows）应返回非空结果
go mod 和 GOPROXY 配置不到位，bee run 会卡住或失败
bee run 不只是启动服务，它还会自动调用 go build、触发依赖下载。如果没开模块模式或代理没设对，项目一跑就卡在 go: downloading... 或直接报错 go: github.com/beego/beego/v2@v2.3.4: Get "https://proxy.golang.org/...": dial tcp: lookup proxy.golang.org: no such host。
这不是 PATH 的问题，但和 PATH 配置常被一起忽略——因为用户以为“装完就能跑”，其实还差两步基础设置。
- 强制开启 Go Modules：
go env -w GO111MODULE=on - 配置国内代理（必做）：
go env -w GOPROXY=https://goproxy.cn,direct - 如果项目已有
go.mod，但依赖混乱，先在项目根目录执行：go mod tidy - 再跑
bee run；若仍失败，看控制台第一行输出是否含Building...，不是就说明没真正开始构建
PATH 生效后仍提示 bee: command not found？检查文件权限和扩展名
尤其在 macOS/Linux 上，即使 $GOPATH/bin 已在 PATH 中，也可能因权限问题无法执行。Windows 则容易混淆 bee 和 bee.exe。
- macOS/Linux：
ls -l $GOPATH/bin/bee看是否有可执行权限（-rwxr-xr-x）。没有就补：chmod +x $GOPATH/bin/bee - Windows：确认
%GOPATH%\bin\bee.exe存在，而不是只有bee（无扩展名）；某些 Go 安装方式会生成无扩展名文件，需手动重命名为bee.exe - 终端里输
bee回车后没反应、也不报错？可能是二进制损坏，删掉$GOPATH/bin/bee*，重新go get -u github.com/beego/bee/v2
PATH 配置本身很简单，但它的上下游依赖（GOROOT、GOPROXY、文件权限、模块开关）任何一个断掉，都会让 bee 表现为“不存在”。最常被跳过的其实是 GO111MODULE=on 和 GOPROXY 这两行，它们不改 PATH，却决定 bee run 能不能真正动起来。
