bee命令找不到需确保gobin路径已加入path，bee new必须在$gopath/src下执行，bee run失败常因go.mod未同步或beego/v2版本不匹配。
直接装 bee 工具并用它生成项目，比手动拉包 + 手动建目录快得多；但多数人卡在 bee 命令找不到或 bee new 报错，核心原因是路径、模块和环境变量没对齐。
bee 命令找不到：GOBIN 和 PATH 必须同时生效
安装 go get github.com/beego/bee/v2 后，bee 二进制默认落在 $GOBIN（不是 $GOPATH/bin）；如果没显式设置 GOBIN，它会 fallback 到 $GOPATH/bin。但无论哪种情况，都必须把该路径加进系统 PATH 环境变量，否则 shell 找不到命令。
- 运行
go env GOBIN确认实际路径，比如输出/home/user/go/bin - 检查
PATH是否包含该路径：echo $PATH | grep "go/bin"（Linux/macOS）或echo %PATH%（Windows） - 没命中就补上：
export PATH=$PATH:$(go env GOBIN)（临时），或写入~/.bashrc/~/.zshrc（永久） - Windows 用户注意：
go env GOBIN可能返回带反斜杠的路径（如C:\Users\xxx\go\bin），添加到 PATH 时用正斜杠或双反斜杠均可，但不要混用
bee new 报错 “must be in $GOPATH/src”：项目根路径有硬性约束
bee new myapp 必须在 $GOPATH/src 目录下执行，否则报错。这不是 bug，是 bee 的设计限制——它依赖 GOPATH 模式组织代码结构，即使你启用了 Go modules，这个检查也绕不过。
- 先确认
go env GOPATH输出，比如/home/user/go - 然后
cd /home/user/go/src，再运行bee new myapp - 生成的项目路径就是
$GOPATH/src/myapp，后续所有操作（如bee run）都要在这个目录下进行 - 如果你习惯用模块化工作区（如放在
~/projects/myapp），那bee就不适用，得手动初始化go mod init+ 复制骨架文件
bee run 启动失败：常见依赖与配置陷阱
bee run 启动时报 missing go.sum 或 cannot find package，本质是模块依赖未拉全或版本冲突。beego v2 默认要求 Go modules，但旧版 bee 或残留的 vendor 会干扰。
- 首次运行前先执行
go mod tidy，确保go.mod和go.sum一致 - 检查
main.go中 import 路径是否为github.com/beego/beego/v2（v2 版本），不是github.com/astaxie/beego（v1 已废弃） -
conf/app.conf中的httpport默认是8080，如果端口被占，改完要重启bee run（热编译不会重读 app.conf 变更） - 若提示
undefined: bee.AppConfig，说明 bee 工具版本和 beego 版本不匹配，统一用v2系列：go get github.com/beego/bee/v2+go get github.com/beego/beego/v2
beego v2 的 ORM 需要显式注册驱动
即使你只打算跑个 Hello World，只要项目里引用了 github.com/beego/beego/v2/client/orm，就必须注册数据库驱动，否则 bee run 会 panic 报 driver: unknown driver "mysql" (forgotten import?)。
- 在
main.go或routers/router.go的 import 块中加入：_ "github.com/go-sql-driver/mysql"
- 仅导入驱动还不够，还得在
init()或main()中调用orm.RegisterDriver和orm.RegisterDataBase，否则 ORM 初始化失败 - 如果暂时不用数据库，最省事的方式是删掉
models目录 + 注释掉routers/router.go中对models的 import，避免隐式触发 ORM 初始化
真正麻烦的不是命令记不住，而是 bee 在后台悄悄依赖 GOPATH 结构、Go modules 状态、驱动 import 语句三者严格对齐——漏掉任意一环，错误信息都不会直说哪错了，只会卡在某个看似无关的环节。
