Beego v2项目必须启用GO111MODULE=on并配置GOPROXY，用go install安装bee工具，依赖需显式go get github.com/beego/beego/v2@latest且import路径含/v2，首次bee new后须执行go mod tidy。
Beego 项目现在必须用 go mod 管理依赖，go get 直接安装框架和 bee 工具在 Go 1.17+ 上已失效；不配代理、不设 GO111MODULE=on，90% 的安装会卡在依赖拉取环节。
Go 环境初始化必须开 module 模式
Beego v2（当前主流版本）完全基于 Go Modules，关闭 module 模式会导致 go get 无法解析版本、找不到 github.com/beego/beego/v2。别信老教程里“不用管 module”的说法。
- 执行
go env -w GO111MODULE=on强制启用模块模式 - 同时配置国内代理：
go env -w GOPROXY=https://goproxy.cn,direct - 验证是否生效：运行
go env | grep -E "(GO111MODULE|GOPROXY)"，输出应为GO111MODULE="on"和GOPROXY="https://goproxy.cn,direct"
bee 工具安装必须用 go install
Go 1.16 起 go get 不再将可执行文件放入 $GOBIN，旧命令 go get github.com/beego/bee 会静默失败或装到错误路径，导致终端报 bee: command not found。
- 正确命令是：
go install github.com/beego/bee/v2@latest - 确认安装位置：
which bee应返回类似/home/xxx/go/bin/bee的路径 - 如果
which bee无输出，检查$GOBIN是否在$PATH中：echo $PATH | grep "$(go env GOPATH)/bin"；没出现就补上：export PATH="$(go env GOPATH)/bin:$PATH"
Beego 框架本身不需全局安装
Beego v2 是纯库，不需要像老版本那样 go get github.com/astaxie/beego 全局安装。它只在项目内按需引入，且必须带 /v2 后缀。
立即学习“go语言免费学习笔记（深入）”；
- 新建项目目录后，先
go mod init myapp - 再
go get github.com/beego/beego/v2@latest—— 这行才是真依赖 - 代码中 import 必须写成：
"github.com/beego/beego/v2/server/web"，漏掉/v2或写成beego会编译失败 - 常见错误：
import "github.com/beego/beego" → no required module provides package，就是没加/v2
第一次 bee new 会生成 go.mod 但不自动拉依赖
bee new myproject 只创建骨架和 go.mod，不会执行 go mod tidy。直接 bee run 十有八九报错：找不到 web.Run() 或 panic on missing module。
- 进入项目根目录后，手动执行：
go mod tidy - 若提示
require github.com/beego/beego/v2版本缺失，补一句：go get github.com/beego/beego/v2@latest - 再跑
bee run，看到INFO ▶ 0001 Starting server...和http://127.0.0.1:8080才算真正就绪
最容易被忽略的是：Beego v2 的路由注册方式、控制器写法、配置加载路径都和 v1 完全不同，照搬旧教程的 beego.Router 或 beego.Run() 会直接 panic。别跳过 go mod tidy，也别省掉 /v2 —— 这俩是当前所有失败的根源。
