Revel v1.1.0+ 必须启用 Go Modules(GO111MODULE=on)、初始化 go.mod、安装新版 CLI(revel@v0.25+)并执行 revel run .,否则因弃用 GOPATH 导致 cannot find package 等错误。

Revel 框架安装时提示 cannot find package,不是你漏装了 Go 或 Git,而是 v1.1.0+ 版本彻底弃用 GOPATH 自动拉取逻辑,所有依赖必须由 Go Modules 显式管理——直接 go get github.com/revel/revel 会失败,因为旧命令链不触发 go.mod 解析。
为什么 go build github.com/revel/revel 报一堆 cannot find package
错误里列出的 github.com/agtorre/gocolorize、github.com/klauspost/compress/gzip 等,并非 Revel 的“可选插件”,而是编译期硬依赖。v1.1.0 要求这些包必须出现在当前模块的 go.mod 中,且路径需与 import 语句完全一致(注意斜杠、大小写、vendor 前缀)。GOPATH 模式下手动放源码到 $GOPATH/src/ 已无效。
- Go Modules 未启用:执行
go env GO111MODULE,输出不是on就得先go env -w GO111MODULE=on - 项目没初始化模块:在空目录下运行
go mod init example.com/app(名字只是导入标识,不用真实存在) - 框架本身没声明为依赖:必须显式添加
github.com/revel/revel v1.1.0,不能靠go get隐式推导
补依赖的正确顺序:先 CLI,再框架,最后 tidy
顺序错一步,revel run 就卡在 “not found in GOPATH” —— 实际是 CLI 版本太老,压根不读 go.mod。
- 升级 CLI:
go install github.com/revel/cmd/revel@latest(不是@v1.1.0,CLI 最新版才识别新框架) - 验证 CLI:
revel version输出应含v0.25或更高 - 初始化项目后,在根目录执行:
go get github.com/revel/revel@v1.1.0,再go mod tidy - 若仍报缺包,不要手动
go get单个路径;改用go mod graph | grep revel查依赖树,再针对性go get对应模块
revel run 启动失败但没报具体包名?检查这三处硬编码路径
某些错误不会列 cannot find package,而是静默退出或 panic,常见于配置残留。Revel v1.1.0 会强制校验以下三项:
-
conf/app.conf中app.name必须与go.mod第一行模块名**前缀一致**(如module github.com/yourname/myapp→app.name = myapp) -
app/init.go开头必须有import "github.com/revel/revel",且不能被 IDE 自动删掉(尤其从旧项目迁移时) -
revel run必须显式传参当前目录:revel run .,省略.会回退到 GOPATH 推断逻辑,直接失败
真正容易被忽略的是:v1.1.0 不再兼容任何 GOPATH 下的项目结构,哪怕你把整个目录挪进 $GOPATH/src 也没用。它只认 go.mod + revel/cmd/revel@v0.25+ + revel run . 这个三角组合。少一个,就不是“缺包”,而是“根本没进模块加载流程”。











