Beego项目必须在$GOPATH/src下执行bee new创建，否则bee run因路径硬编码失败；需确保conf/、routers/等标准目录存在，且router.go中init()函数显式注册路由。
Beego 项目不能在任意路径下用 bee new 创建，否则后续 bee run 必然失败 —— 根本原因在于路径硬编码和 GOPATH 依赖。
bee new 必须在 $GOPATH/src 下执行
Beego 的 bee 工具默认把项目生成到 $GOPATH/src/，且后续所有查找（如 conf/app.conf、routers/router.go）都基于该路径做相对解析。不在 $GOPATH/src 下运行 bee new myapp，会导致：
-
bee run报错：conf file not found或直接 panic - 控制器方法不被调用（路由注册失败，404）
- 静态文件路径错乱、模板加载失败
正确操作顺序：
检查 GOPATH：go env GOPATH
进入 src 目录：cd $(go env GOPATH)/src
创建项目：bee new myapp（不要加任何路径前缀）
生成后，项目根目录结构必须包含 conf/、controllers/、routers/、main.go 等标准子目录 —— 缺一不可。
bee run 启动失败的常见原因
bee run 不是通用启动命令，它强依赖当前工作目录和项目结构一致性。以下任一条件不满足，都会失败：
- 不在项目根目录（即
$GOPATH/src/myapp）下执行 - 项目中缺失
routers/router.go或其init()函数为空 -
main.go中没调用beego.Run()（v2 版本需确认是否用了github.com/beego/beego/v2导入） - Go Modules 开启时未禁用 GOPATH 模式（GO111MODULE=on 但项目仍在 GOPATH/src 下），可能引发导入路径冲突
验证方式：进项目根目录后，手动运行 go run main.go。若能启动且访问 http://localhost:8080 成功，说明框架基础没问题；若失败，则是 bee run 自身环境或配置问题。
bee api 和 bee new 的关键区别
二者生成的目录结构和默认依赖不同，选错会导致后续开发卡住：
-
bee new myweb：生成完整 MVC 结构，含views/、static/、models/，适合传统 Web 页面项目 -
bee api myapi：不生成views/和static/，控制器默认返回 JSON，预置了object.go和user.go示例，适合纯接口服务 - 两者都**不会自动初始化数据库或 ORM**，
models/目录只是占位，需手动 importgithub.com/beego/beego/v2/client/orm并调用orm.RegisterDriver
注意：bee api 生成的项目仍需在 routers/router.go 中显式注册路由 —— 它不会帮你写 beego.Router("/user", &controllers.UserController{})。
Go Modules 项目能否用 bee？
可以，但必须绕过 GOPATH 限制并手动补全约定路径：
- 先
go mod init myapp初始化模块，再手动创建conf/app.conf、routers/router.go等目录和文件 -
bee run仍会尝试按 GOPATH 规则找配置，所以得用go run main.go启动，并在main.go开头加：beego.LoadAppConfig("ini", "conf/app.conf") -
bee new在 GO111MODULE=on 时基本失效，强行使用会导致路径错乱、go build找不到包
结论：新项目建议直接用 Go Modules + 手动搭建，或严格守在 GOPATH/src 下用 bee —— 混用两者是 Beego 项目最常翻车的点。
真正麻烦的不是命令记不住，而是 bee 表面封装了一层“自动化”，实则把路径、初始化顺序、配置加载时机这些细节全锁死了。一个 conf/app.conf 放错位置，或 init() 里少调一次 beego.Router，整个服务就静默挂掉，连日志都不输出。
