Beego 快速搭建后端的关键在于：必须启用 Go Modules（GO111MODULE=on），避免在 GOPATH/src 下直接初始化，严格区分 bee run 的配置加载逻辑与路由注册规则（Router/RESTRouter），并确保控制器方法名首字母大写、模板路径精确匹配。
Beego 能快速搭出可用后端，但“快”不等于“无脑执行”，关键在选对初始化路径、避开默认配置陷阱、以及理解 bee 工具和框架启动逻辑的分工。
用 bee new 初始化项目前先确认 Go 模块模式已启用
Beego v2+ 强依赖 Go Modules，bee new myapi 会自动生成 go.mod，但如果当前目录已在某个旧模块下（比如 GOPATH/src 下），或环境变量 GO111MODULE 被设为 off，生成的项目会缺少依赖声明，后续 bee run 报错 cannot find package "github.com/beego/beego/v2"。
- 运行
go env GO111MODULE，确保输出是on；不是就执行go env -w GO111MODULE=on - 别在
$GOPATH/src下直接bee new，建议新建空目录再操作 -
bee new后立刻检查生成的go.mod是否包含github.com/beego/beego/v2 v2.3.4（以实际最新版为准）
bee run 启动失败常见原因及对应检查点
bee run 不是单纯执行 go run main.go，它会读取 conf/app.conf、监听文件变化、注入调试信息。很多“启动不了”其实卡在配置或路径上。
- 端口被占：默认
8080，报错类似listen tcp :8080: bind: address already in use→ 改conf/app.conf中的httpport = 8081 - 路由注册没生效：
routers/router.go里init()函数未被调用 → 确认该文件被main.go的import _ "myapp/routers"显式导入 - 控制器方法名大小写错误：
Get()写成get()或GET()→ Beego 只识别首字母大写的 HTTP 方法名 - 模板路径错位：启用视图渲染时，
c.TplName = "index.tpl"但文件实际在views/admin/index.tpl→ 应写成c.TplName = "admin/index.tpl"
RESTful 路由注册别混用 Router 和 RESTRouter
Beego 提供两套路由注册方式，语义和行为完全不同，混用会导致方法匹配失效或 panic。
-
beego.Router("/api/users", &controllers.UserController{})：只绑定一个固定路径，所有 HTTP 方法都进同一个控制器，需手动在Get()/Post()里判断c.Ctx.Input.Method -
beego.RESTRouter("/api/users", &controllers.UserController{})：自动按 HTTP 方法映射到同名方法，GET /api/users → Get()，POST /api/users → Post()，且支持:id参数解析 - 若用
RESTRouter，控制器必须嵌入beego.Controller，且不能漏掉任意一个要支持的方法（比如只写Get()却发PUT请求，会 405）
热重载（bee run）下模型/配置变更不生效怎么办
bee run 的热重载只监控 .go 文件内容变更并触发 rebuild，但以下两类修改不会自动 reload：
-
conf/app.conf修改后必须手动Ctrl+C停掉进程再bee run，否则仍用旧配置（比如改了runmode = prod但日志还是 debug 级） -
models/下结构体字段加了ormtag（如`orm:"pk;auto"`），但没执行bee generate docs或手动调orm.RegisterModel→ ORM 不会识别新字段 - 静态文件（
static/）变更虽能实时访问，但浏览器可能缓存，建议开发期禁用缓存或加时间戳参数
真正影响上线速度的，往往不是代码写多快，而是哪次 app.conf 里少改了一个 =，或者哪个 init() 函数忘了 import。Beego 的“快”，建立在对模块加载顺序和配置优先级的明确预期之上——它不隐藏机制，只压缩样板。
