beego.run()报undefined是因v1与v2混用：需改import为"github.com/beego/beego/v2/server/web"，启动用web.run()，控制器嵌入web.controller，且确保无github.com/astaxie/beego残留。
beego.Run() 报 undefined 是最常见依赖冲突信号
这不是真正的“包冲突”，而是 v1 和 v2 混用导致的符号找不到。只要代码里还写着 import "github.com/astaxie/beego" 或调用 beego.Run()，哪怕 go.mod 里声明的是 v2，Go 编译器也会因路径不匹配而拒绝解析。
- 检查
main.go：确认 import 路径是"github.com/beego/beego/v2/server/web"，不是旧路径 - 启动函数必须是
web.Run()，不是beego.Run() - 控制器结构体嵌入必须是
web.Controller，不能是beego.Controller - 如果项目里还有
github.com/astaxie/beego的残留 import，哪怕只在某个 test 文件里，也会触发 go build 失败
go mod tidy 失败并提示 missing go.sum entry
这说明模块校验失败，不是 beego 特有，但常在新项目初始化时暴露。根本原因是 go.sum 缺少对应依赖的哈希记录，通常因 GOPROXY 未生效或本地缓存损坏。
- 先执行
go env -w GOPROXY=https://goproxy.cn,direct强制启用国内代理 - 再运行
go mod tidy—— 不要跳过这步，它会补全go.sum并修正版本对齐 - 若仍失败，执行
go clean -modcache清空本地模块缓存，再重试go mod tidy - 注意：
bee new创建的项目默认不含go.mod，必须先go mod init myapp再go mod tidy
同时维护 v1 和 v2 项目时出现版本错乱
Go Modules 不支持同一路径下多版本共存，github.com/astaxie/beego 和 github.com/beego/beego/v2 是两个完全独立的导入路径，但如果你在 GOPATH 模式下混用，或者 go.mod 里用 replace 指向错误路径，就会引发隐性冲突。
- 绝对不要在 v2 项目中使用
replace github.com/astaxie/beego => ...，这会污染模块图 - 如需临时调试旧 v1 项目，建议单独开终端并设置
GO111MODULE=off，避免与当前 v2 模块环境交叉 - 长期共存方案：用
replace只针对自己的私有 fork（如replace github.com/beego/beego/v2 => ./local-beego-v2），而非官方路径 - v1 项目应尽快迁移，因为
github.com/astaxie/beego已归档，所有安全更新和 bug 修复仅在 v2 发布
routers 包没生效导致所有路由 notmatch
这是最隐蔽的“依赖冲突”——表面看 go build 成功、bee run 启动无报错，但访问任何路径都返回 notmatch。根源是 Go 的包加载机制：未被 import 的包，其 init() 函数根本不会执行，而 beego 的路由注册就靠 routers/router.go 里的 init() 完成。
- 在
main.go顶部添加空白导入：_ "yourapp/routers"（把yourapp换成你项目的实际 module 名） - 确保
routers/router.go文件存在，且里面调用了web.Router()或web.AutoRouter() - 别写成
import "yourapp/routers"—— 没有下划线会导致编译器优化掉该包，init()仍不执行 - 这个坑和依赖版本无关，但现象像“路由模块没装上”，容易误判为安装问题
真正麻烦的不是报错，而是静默失效：比如 routers 没导入、init() 跳过、go.sum 校验失败却没中断构建。这些都不会直接告诉你“依赖冲突”，只会让程序跑不起来或行为异常。动手前先看一眼 go.mod 里的路径是否全为 /v2，再扫一遍所有 import 语句 —— 大部分问题其实卡在这两行上。
