Beego 框架自2023年12月起官方归档，停止维护、不接受PR、无安全更新；最新可用稳定版为v2.0.2（2022年9月发布），仅支持Go 1.16–1.19，Go 1.20+存在embed冲突及运行时panic。
Beego 框架现在不推荐新项目使用 —— 官方已停止维护（2023 年 12 月起归档），beego 主仓库标记为 archived，不再接受 PR、不发布新版本、无安全更新。
为什么 go get github.com/beego/beego/v2 会失败或拉不到最新版
因为 v2 分支已冻结，而 v1 在 Go Module 下兼容性差；常见报错是 unknown revision v2.1.0 或 module github.com/beego/beego/v2: reading https://goproxy.io/github.com/beego/beego/v2/@v/v2.1.0.info: 404 Not Found。
- 真实可用的最新稳定版是
v2.0.2（2022 年 9 月发布），但仅支持 Go 1.16–1.19，Go 1.20+ 会出现embed冲突或go:embed路径解析异常 - 如果你用的是 Go 1.20+，
go mod tidy可能静默跳过beego依赖，或在运行时 panic：panic: reflect: Call of nil func value（源于内部reflect.Value.Call调用空函数指针） - 替代方案：改用
go get github.com/beego/beego/v2@v2.0.2锁死版本，并在go.mod中显式 replace 到本地缓存路径（避免代理返回 404）
bee new 创建项目后无法启动：端口绑定失败或路由 404
默认生成的 main.go 里 beego.Run() 启动逻辑没问题，但实际失败往往卡在配置加载或路由注册时机上。
- 检查
conf/app.conf是否存在且编码为 UTF-8 无 BOM；Windows 记事本保存易带 BOM，导致beego.LoadAppConfig("ini", "conf/app.conf")解析失败，静默忽略配置，服务默认监听:8080却不报错 -
router/router.go中的beego.Router必须在beego.Run()前执行；如果误写成函数内调用（如包级变量初始化时未触发），路由表为空，所有请求返回 404 - 若用
bee run启动，确保当前目录是项目根目录（含go.mod和conf/），否则bee找不到配置，直接 fallback 到默认路由规则
模板渲染报 template: xxx: no such template 或静态文件 404
Beego 的模板和静态资源路径不是“相对当前文件”，而是基于 beego.BConfig.WebConfig.StaticDir 和 beego.BConfig.WebConfig.ViewsPath 的绝对路径查找。
立即学习“go语言免费学习笔记（深入）”；
- 默认
ViewsPath是"views"，但必须是相对于可执行文件所在目录（非main.go目录）；用bee run时工作目录是项目根，但用go run main.go时工作目录是main.go所在目录，容易错位 - 静态文件（CSS/JS）需在
conf/app.conf显式配置：staticdir = static，且目录名必须与配置值完全一致（区分大小写），不能写成StaticDir或staticDir - 模板中引用子模板用
{{template "header.html" .}}，但 Beego 不自动扫描子目录，"header.html"必须与主模板在同一views/目录下，否则报错
Beego 最难调试的问题，往往不是语法错误，而是路径语义模糊 + 配置隐式 fallback —— 它不会告诉你“没找到 views 目录”，只会返回空白页或 404。真要继续用，务必在 main.go 开头加 beego.BeeLogger.Level = logs.LevelDebug，并检查日志里是否有 load view path 或 static dir not exist 提示。
