Revel CLI 工具须用 go install github.com/revel/cmd/revel@latest 安装(Go 1.21+ 不支持 go get),需确保 GO111MODULE=on、Go≥1.18,并将 $GOPATH/bin 加入 PATH;验证执行 revel version。

Revel 命令行工具现在必须用 go install 安装,go get 已失效(Go 1.21+ 默认禁用 GOPATH 模式且移除了该命令)。直接执行旧教程里的 go get github.com/revel/cmd/revel 会报错或静默失败。
确认 Go 环境与模块模式已启用
Revel 当前版本(v1.1.0+)强制依赖 Go Modules,不兼容 GOPATH 工作流。先验证基础环境:
-
go version必须 ≥ 1.18(推荐 1.21+) -
go env GO111MODULE输出应为on或空(非off) - 无需手动设置
GOPATH;项目可放在任意路径,如~/code/myapp
安装 revel CLI 工具(仅一行命令)
在终端中运行:
go install github.com/revel/cmd/revel@latest
安装完成后,revel 命令会落在 $GOPATH/bin(或 go env GOPATH 输出路径下的 bin/ 目录)。确保该路径已加入 $PATH:
- macOS/Linux:检查
echo $PATH是否含$HOME/go/bin(默认 GOPATH) - Windows:确认系统环境变量
PATH包含%USERPROFILE%\go\bin - 验证:
revel version应输出类似Revel Framework v1.1.0(2022-04-11)
创建并启动第一个 Revel 应用
进入工作目录(如 ~/code),执行:
revel new -a myapp -r
该命令会:
- 生成标准 Revel 项目结构(含
app/、conf/、public/、tests/) - 自动初始化
go.mod(模块名默认为github.com/revel/example-myapp,可后续修改) - 立即启动开发服务器,默认监听
0.0.0.0:9000
⚠️ 注意:若访问 http://localhost:9000 失败,大概率是端口被占或防火墙拦截。此时应显式绑定本地地址:
revel run -a myapp -p 9000 -addr 127.0.0.1
常见失败点与绕过方式
以下错误出现时,不要重装 Go 或降级版本:
-
command not found: revel→ 检查$PATH是否包含go install输出的 bin 路径,不是 GOPATH/src -
no required module provides package github.com/revel/cmd/revel→ 说明 Go 版本太低或网络问题,换国内代理(如export GOPROXY=https://goproxy.cn,direct)再试 -
revel run: app not found→ 确认当前目录是项目根目录(含conf/app.conf和go.mod),不是子目录 - 启动后页面空白或 500 → 检查
conf/app.conf中app.name是否与-a参数一致,大小写敏感
真正卡住的地方往往不是框架本身,而是 Go 模块路径解析和二进制命令的 PATH 可见性——这两点比当年 GOPATH 时代更隐蔽,但只要盯住 go install 输出路径和 revel version 能否执行,就能快速定位。


















