beego v1.x 升级到 v2.x 不支持平滑升级，必须手动迁移五处核心：入口启动、配置读取、路由注册、ORM 替换、模板与静态资源路径；go get -u 无效，bee 工具也无法自动修复。
beego 旧版本（v1.x）到 v2.x **不存在平滑升级**。这不是版本号跳变的问题，而是两个完全不同的框架：v2 是重写的、不兼容的全新实现。所谓“升级安装”其实是“弃旧建新”，必须手动迁移代码。
beego v1 升级到 v2 是否能 go get -u？
能执行，但没用。
-
go get -u github.com/astaxie/beego会把 v2 的代码拉下来，但 v1 的beego.Run()、beego.Router()、orm.NewOrm()等全部无法编译通过 - v2 的模块路径已改为
github.com/beego/beego/v2（注意末尾/v2），而 v1 是github.com/astaxie/beego，Go Module 会视为两个独立包 - 直接替换 import 路径后，90% 以上调用点都会报错：函数不存在、参数不匹配、类型不兼容
bee 工具能自动修复 v1 到 v2 吗？
不能。bee v2 的 bee fix 命令只支持 v1.x 内部小版本间语法微调（如 GetInt → GetInt64），对 v2 的核心重构无感知。
-
bee fix不会改main.go入口逻辑，不会重写路由注册方式，也不会转换 ORM 初始化流程 - 它甚至无法识别你项目里用了
beego/orm—— 因为 v2 已彻底移除该子包 - 运行
bee migrate时，如果项目还在用 v1 的database/sql+ 自定义连接池，v2 的迁移机制（beego/migration）也需重新适配路径和驱动注册
实际迁移要重写的最小核心模块有哪些？
以下五处不改，项目根本起不来：
-
入口启动：v1 的
beego.Run()必须删掉，改用beego.App.Run(":8080")，且所有路由、中间件、配置加载都得在Run()前完成 -
配置读取：
beego.Config.String("appname")失效，改用beego.AppConfig.String("appname")；环境变量前缀（如APP_NAME）不再自动映射，需显式调用beego.AppConfig.SetEnvPrefix("APP") -
路由注册：v1 的
beego.Router("/user/:id", &controllers.UserController{})仍可用，但参数获取从c.Ctx.Input.Param(":id")改为c.PathParam("id") -
ORM 替换：v1 的
github.com/astaxie/beego/orm彻底废弃；v2 推荐直接用database/sql+github.com/go-sql-driver/mysql，或集成gorm.io/gorm；若坚持用beego/orm/v2，需手动orm.RegisterDriver()和orm.RegisterModel() -
模板与静态资源：v2 中
this.TplName = "index.tpl"必须写成this.TplName = "views/index.tpl"（带views/前缀）；静态文件不再自动托管static/，需显式调用beego.BeeApp.Handlers.Add("/static", http.StripPrefix("/static", http.FileServer(http.Dir("static"))))
