beego博客系统需显式启用orm、session并规范模型标签与模板变量命名。必须在init()中注册数据库和驱动，conf/app.conf开启sessionon，time.time字段须配orm:"auto_now_add;type(datetime)"标签，模板变量名须与c.data键完全一致。
Beego 博客系统不是“照着教程敲完就能跑通”的玩具项目，它天然带有多模型关联、用户状态管理、模板动态渲染和数据库事务等真实 Web 场景的复杂度。直接用 bee new blog 创建空壳再硬补功能，大概率会在 session 未启用、ORM 未注册、路由未加载或模板变量未传入时卡住——这些不是 bug，而是 Beego 的显式契约。
beego.Run() 前必须完成 ORM 注册和 Session 初始化
很多人在 main.go 中只写 beego.Run() 就启动服务，结果 orm.ReadOrCreate() panic 或 c.GetSession("uid") 返回 nil。这是因为 Beego 的 ORM 和 Session 都是可选模块，需显式启用。
- 在
main.go的import块中加入：_ "github.com/beego/beego/v2/client/orm"和_ "github.com/beego/beego/v2/plugins/cors"（后者非必需，但跨域调试常用） - 在
init()函数里调用orm.RegisterDriver("mysql", orm.DRMySQL)和orm.RegisterDataBase("default", "mysql", "root:123456@tcp(127.0.0.1:3306)/blog?charset=utf8mb4") - 在
conf/app.conf中开启 session：sessionon = true，并指定存储方式，例如：sessionprovider = memory（开发用）或sessionprovider = file
Article 模型中 time.Time 字段必须配 orm 标签才自动写入
Beego ORM 不会自动识别 time.Time 类型字段为时间戳，若不加标签，Created 和 Updated 在插入时会是零值（1970-01-01），且不会触发 auto_now_add 或 auto_now 行为。
- 正确写法示例：
Created time.Time `orm:"auto_now_add;type(datetime)"` -
type(datetime)是 MySQL 兼容写法；SQLite 用type(datetime)或type(timestamp)均可，PostgreSQL 推荐type(timestamp with time zone) - 若字段名是
CreateTime而非Created，标签仍需保持小写形式：orm:"column(create_time);auto_now_add"，否则 ORM 无法映射
模板中 {{.Data}} 和 {{.Xxx}} 的传值逻辑容易混淆
Beego 的模板变量来自 c.Data map，但控制器中赋值方式不同会导致渲染失败。常见错误是直接写 c.Data["title"] = "My Blog"，却在模板里写 {{.Title}}（首字母大写）。
- 模板中引用的 key 名必须与
c.Data中的 key 完全一致（区分大小写） - 推荐统一用小写加下划线风格：
c.Data["page_title"] = "首页"→ 模板中写{{.page_title}} - 若要传结构体，必须导出字段（首字母大写），且模板中访问方式为
{{.User.Name}}，前提是c.Data["User"] = userStruct - 不要依赖
{{.}}直接展开整个c.Data，Beego 不支持这种 Go 模板原生语法，会报template: index.tpl:12: unexpected "." in operand
bee run 热编译不生效？检查 GOPATH 和 go.mod 冲突
执行 bee run 后修改代码无反应，浏览器刷新仍是旧内容，通常不是 bee 本身故障，而是 Go 模块路径解析错乱。
- 确认项目根目录下有
go.mod文件，且其中module名与import路径一致（如module myblog，则所有import "myblog/controllers"才有效） - 若项目在
$GOPATH/src下，但又初始化了go mod，bee 可能同时读取 GOPATH 和 module 路径，导致编译缓存错位 - 临时解决：删掉
go.mod和go.sum，用 GOPATH 模式运行；或彻底迁移到 module 模式，把项目移出 GOPATH，并在main.go中用完整模块路径导入 routers（如_ "myblog/routers"）
最常被忽略的一点：Beego 的 app.conf 中 runmode = dev 不仅影响日志级别，还决定是否加载 router.go 中的 Include 子路由——生产模式下若没显式 Include，子控制器根本不会被注册。
