必须先配置go模块支持、国内代理和path环境变量;再用go install安装beego/v2和bee/v2,将$gobin加入path后执行bee new myapp并bee run验证。

要在本地Go开发环境中成功安装Beego框架并确保后续能用bee工具创建和运行项目,必须先满足Go模块支持、代理可用、环境变量就绪三个前提条件,缺一不可。
确认Go环境已就绪
打开终端,执行 go version,确认输出类似 go version go1.21.0 darwin/arm64 或更高版本;若报错或版本低于1.16,需先重装Go。
运行 go env GOPATH 查看工作目录路径,记下该路径(如 /Users/xxx/go),后续所有操作都以此为基准。
【GOPATH必须存在且可写,否则go get会静默失败】
启用模块并配置国内代理
执行以下两条命令,强制开启模块支持并设置稳定代理:
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct
这两步不执行,后续安装beego或bee时大概率卡在 golang.org/x/... 类依赖上,报连接超时或 unrecognized import path 错误。
安装Beego核心包
方法一(推荐,v2主干):
执行 go install github.com/beego/beego/v2@latest。
注意:不是 go get,新版Go(1.17+)默认禁用 go get 安装可执行文件,go install 才是正确方式。
方法二(兼容旧项目):
执行 go install github.com/astaxie/beego@latest。
该命令安装的是 legacy v1 版本,仅用于维护老项目,新项目请勿使用。
安装完成后,不会生成可执行文件,但会在 $GOPATH/pkg/mod/ 下缓存源码,供项目引用。
安装bee开发工具
第一步:执行 go install github.com/beego/bee/v2@latest。
这一步会编译生成 bee 二进制文件,并自动放入 $GOBIN 目录(通常与 $GOPATH/bin 相同)。
第二步:确认 bee 命令是否可用:
执行 bee version,应输出类似 v2.1.0 的版本号;
若提示 command not found,说明 $GOBIN 未加入系统 PATH。
第三步(Windows用户必做):
将 %GOPATH%\bin 添加到系统环境变量 Path 中;
重启终端后再次运行 bee version 验证。
【$GOBIN 必须在 PATH 中,否则 bee new / bee run 均无法识别】
验证安装并初始化首个项目
① 进入 $GOPATH/src 目录:cd $GOPATH/src(macOS/Linux)或 cd %GOPATH%\src(Windows)。
② 创建新项目:bee new myapp。
成功时会打印多行 create ... 日志,并在当前目录生成 myapp/ 文件夹。
③ 进入项目目录:cd myapp。
④ 启动服务:bee run。
看到日志中出现 Starting server at http://localhost:8080 即表示Beego已安装成功并正常运行。











