beego v2 是彻底重写的不兼容版本，必须重写入口（改用 beego.App.Run()）、路由、中间件、配置（beego.AppConfig）、ORM（弃用旧 orm 包，需注册驱动和模型）、模板路径（需带扩展名）、静态资源（需显式挂载）及中间件作用域（须指定 BEFOREROUTER 等阶段）。
beego v1 升级到 v2 的核心变化是什么
beego v2 不是简单版本号递增，而是彻底重写了核心模块，beego v1 和 beego v2 之间不兼容。最直接的结论是：不能“平滑升级”，必须重写入口、路由、中间件、配置加载和 ORM 使用方式。官方也明确标注 v2 是“全新框架”，v1 的代码在 v2 下基本无法直接运行。
main.go 和应用初始化怎么改
v1 的 beego.Run() 启动方式在 v2 中已移除，v2 使用标准 net/http 风格的 http.ListenAndServe()，所有逻辑围绕 beego.App 实例展开。
- v1 入口典型写法：
beego.Run()或beego.BeeApp.Run() - v2 入口必须显式创建
beego.App，调用Run()并传入端口（如:8080），且需提前注册路由和模块 - 全局配置不再通过
beego.Config读取，改用beego.AppConfig（类型为*config.Config），且默认只加载conf/app.conf，不自动识别ENV变量前缀 - 如果你用了
beego.Router的字符串路由写法（如/user/:id），v2 中仍支持，但参数获取方式变为c.Ctx.Input.Param(":id")→ 改为c.GetString(":id")或更推荐的c.PathParam("id")
ORM 模块迁移要注意什么
v2 完全弃用了 v1 的 orm 包（github.com/astaxie/beego/orm），转而推荐使用标准库风格的 database/sql + 第三方驱动，或集成 gorm/xorm 等成熟 ORM。官方提供的 beego/orm v2 是全新实现，API 不兼容：
- 旧版
o := orm.NewOrm()在 v2 中不存在；新 ORM 初始化需先注册驱动：orm.RegisterDriver("mysql", orm.DRMySQL)，再注册模型：orm.RegisterModel(new(User)) -
QueryTable("user").Filter("status", 1).All(&users)这类链式调用在 v2 中参数顺序和返回值有变，例如All()第二个参数必须是interface{}切片指针，且不再自动处理字段映射，需确保结构体 tag 显式声明orm:"column(name)" - v2 ORM 默认关闭日志，调试时需手动开启：
orm.Debug = true，否则看不到 SQL 输出 - 事务操作从
o.Begin()改为o.BeginTx()，且Commit()/Rollback()必须显式调用，无 defer 自动管理
模板渲染和静态资源路径容易出错的地方
v2 的模板引擎默认仍用 html/template，但查找路径逻辑收紧：v1 中 views/ 下任意子目录的模板可被 this.TplName = "admin/index.tpl" 直接加载；v2 要求 TplName 必须是相对 views/ 的完整路径，且扩展名不可省略（即必须写 "admin/index.tpl"，不能写 "admin/index"）。
- 静态文件服务不再由
beego.StaticDir全局配置驱动，改为显式调用beego.BConfig.WebConfig.StaticDir设置映射，或更推荐用beego.NSRouter手动挂载：ns.Get("/static/*s", beego.StaticServer("static")) -
AssetFS嵌入方式变更：v1 支持go:embed+assetfs.AssetFS，v2 需配合beego.EmbedFS使用，且必须在beego.App.Run()前调用beego.SetStaticFS("static", http.FS(assets)) - 模板中
{{.xsrf_token}}在 v2 中默认禁用，若需 CSRF 保护，要手动启用：beego.BConfig.WebConfig.XSRFKEY = "your-key"，并确保请求含X-Xsrftokenheader
真正耗时的不是语法替换，而是 v2 把原来“约定优于配置”的隐式行为全部显式化了——路由注册、中间件注入、配置加载、错误处理都得一行行补全。最容易被忽略的是中间件执行顺序：v1 的 InsertFilter 是全局前置，v2 的 InsertFilterChain 必须指定作用域（beego.BEFORE_ROUTER / beego.AFTER_EXEC），漏写或写错阶段会导致中间件完全不触发。
