先确认bee是否在PATH中:bee默认安装于$GOPATH/bin或$GOBIN,需将该路径加入系统环境变量并重启终端或GoLand;若仍无效,检查go.mod是否初始化并执行go mod tidy。

GoLand 里没找到 bee 命令?先确认它真在 PATH 里
很多人执行 bee new myapp 报错 command not found: bee,不是 GoLand 的问题,而是 bee 可执行文件根本没被系统识别。Beego 的脚手架工具 bee 安装后默认放在 $GOPATH/bin(旧版)或 $GOBIN(新版),但 GoLand 不自动继承 shell 的 PATH。
验证方式:在终端运行 which bee 或 bee version;如果失败,说明安装路径没加进系统环境变量。
- Linux/macOS:检查
~/.bashrc或~/.zshrc是否有export PATH=$PATH:$GOPATH/bin(或$GOBIN),然后source它 - Windows:把
%GOPATH%\bin或%GOBIN%加到系统环境变量Path中 - GoLand 启动前必须重启终端或重新登录系统,否则新 PATH 不生效
go mod init 和 go mod tidy 必须手动补全
用 bee new 创建的项目默认不带 go.mod,而 GoLand 默认启用 Go Modules 模式。如果不手动初始化模块,IDE 会报 “no Go files in directory” 或依赖标红,controllers、models 等包无法跳转。
- 在项目根目录打开终端,运行
go mod init your-module-name(模块名建议用域名格式,如example.com/myapp) - 再运行
go mod tidy下载github.com/astaxie/beego及其间接依赖 - 若
go.mod中出现replace语句(比如指向内网 Git 地址),要确认该仓库可访问,否则tidy会卡住或失败
GoLand 调试 Beego 项目时,main.go 需显式设置运行配置
Beego 项目启动靠 main.Run(),但 GoLand 默认不会自动识别这个入口。直接点绿色三角 ▶️ 会提示 “No run configuration”,或者跑起来但监听不到请求。
- 菜单栏选 Run → Edit Configurations…
- 点击左上角
+→ 选Go Build -
Run kind选Package,Package path填.(当前目录) -
Program arguments留空;Working directory设为项目根目录 - 务必勾选
Allow parallel run(避免多次bee run冲突)
Beego v2+ 和 v1.x 在 GoLand 中的兼容性差异
现在主流是 Beego v2(基于 Go Modules 原生支持),但很多老教程和私有项目还在用 v1.x。两者在 GoLand 里的表现差别很大:
- v1.x 依赖
GOROOT和GOPATH,GoLand 的Go Modules Integration插件可能误判依赖路径,导致beego.AppConfig等类型标红 - v2+ 强制要求
go mod,且包导入路径是github.com/beego/beego/v2,不是github.com/astaxie/beego—— 拼错就会编译失败 - 如果你看到
undefined: beego,先检查import语句是否用了v2后缀,再看go.mod里require行是否匹配
最易忽略的一点:Beego v2 的路由注册方式变了,beego.Router() 依然可用,但推荐用 beego.AddRoute() 或注解方式;GoLand 的代码补全对 v2 支持更完整,但前提是 go.mod 正确且无 replace 干扰。


















