bee命令未找到是因bee工具未加入path，需运行go install github.com/beego/bee@latest并把$gobin或$gopath/bin加入系统path，再执行which bee验证。
beego install 命令报 command not found 怎么办
这不是 beego 安装失败，而是 bee 工具没进系统 PATH。beego 本身是 Go 包，不提供全局命令；真正提供 bee 命令的是配套工具包 github.com/beego/bee。
执行前确认：go version ≥ 1.16（旧版需关 GO111MODULE=off），且已设置 GOBIN 或依赖默认 $GOPATH/bin。
- 运行
go install github.com/beego/bee@latest（Go 1.16+ 推荐） - 若提示
cannot find module providing package，先go env -w GO111MODULE=on - 安装后检查：
which bee，若为空，把$GOBIN或$GOPATH/bin加进 shell 的PATH
执行 bee new myapp 报 failed to load config file
这是 bee 尝试读取本地 bee.json 或用户级配置时出错，常见于首次使用或配置路径权限异常。
- 先删掉疑似残留配置：
rm -f ~/bee.json ~/.bee.json - 避免在 root 下运行
bee，否则可能生成 root 权限的配置文件，后续普通用户无法读取 - bee v2+ 默认不再自动生成全局配置，如需定制模板路径，手动创建
~/bee.json并写入合法 JSON（字段名必须小写，如"gopath"，不能写"GOPATH"）
go run main.go 启动报 undefined: beego.Run
说明项目没正确导入 beego 模块，或模块版本与代码语法不匹配。beego v2 要求显式导入 github.com/beego/beego/v2，且入口函数变为 beego.Run()。
- 检查
go.mod是否含github.com/beego/beego/v2 v2.3.4类似行（v2 系列必须带/v2路径） - 确认
main.go中 import 是"github.com/beego/beego/v2"，不是"github.com/astaxie/beego"（老版本路径） - v2 不再兼容
beego.Run()以外的启动方式；若用beego.BeeApp.Start()，需改用beego.NewApplication().Run()
Windows 下 bee run 编译失败，提示 exec: "gcc": executable file not found
beego 项目若依赖 cgo（比如用了 sqlite、zlib 或某些日志库），Windows 默认无 gcc 环境，bee run 会卡住或报错。
- 最简方案：临时禁用 cgo，运行前设环境变量
CGO_ENABLED=0（PowerShell：$env:CGO_ENABLED="0"） - 若必须启用 cgo，安装 TDM-GCC 或 MinGW-w64，并确保
gcc在 PATH 中（验证：gcc --version） - 注意：禁用 cgo 后，部分驱动（如
_ "github.com/mattn/go-sqlite3"）将无法工作，需换纯 Go 实现（如modernc.org/sqlite）
beego 的坑多集中在路径、模块版本和环境变量三者交界处；只要确保 go.mod 路径对、bee 可执行、cgo 需求与环境匹配，90% 的安装问题就消掉了。真正容易被忽略的是 Windows 下 CGO_ENABLED 的默认值和 bee.json 的隐式加载行为——它们不会报错，但会让后续命令静默失败。
