Revel CLI 必须用 go install github.com/revel/cmd/revel@latest 安装,Go 1.19+ 为硬性要求;需将 $GOPATH/bin 加入 PATH,配置 GOPROXY 解决国内依赖拉取失败,并手动配置 routes 与控制器才能脱离欢迎页。

revel 命令行工具现在必须用 go install github.com/revel/cmd/revel@latest 安装,旧的 go get 路径全部失效,且 Go 1.19+ 是硬性门槛。
revel 命令找不到?先确认 GOPATH/bin 是否在 PATH 里
安装后执行 revel version 报 command not found,不是没装上,而是 shell 找不到二进制文件。Revel 的 CLI 工具默认生成在 $GOPATH/bin/revel,这个路径必须显式加入 PATH:
- Linux/macOS:运行
export PATH="$PATH:$GOPATH/bin",并写入~/.bashrc或~/.zshrc - Windows:把
%GOPATH%\bin加到「系统环境变量」的Path中,重启终端 - 验证方式:执行
which revel(macOS/Linux)或where revel(Windows),有输出即成功
创建应用时卡在依赖下载?优先配 GOPROXY
revel new -a myapp 首次运行会自动拉取 golang.org/x/... 等包,国内直连基本失败。别手动 clone 或找镜像站下 zip 包——太容易路径错、版本乱:
- 临时生效:执行
GOPROXY=https://goproxy.cn go install github.com/revel/cmd/revel@latest - 全局生效:运行
go env -w GOPROXY=https://goproxy.cn - 若仍报错(如
cannot find package "github.com/revel/config"),说明模块未正确解析,可尝试在项目目录下补跑go mod tidy
revel run 启动后访问 9000 空白页?检查监听地址和开发模式
默认 revel run myapp 绑定的是 0.0.0.0:9000,但某些系统防火墙或 Docker 环境会拦截该地址。开发阶段建议显式指定:
- 本地调试加
-addr 127.0.0.1:运行revel run myapp -addr 127.0.0.1 - 确保
conf/app.conf中run.mode = dev,否则静态资源路由、热重载等机制不启用 - 浏览器打开
http://127.0.0.1:9000,而不是http://localhost:9000(部分 hosts 配置下二者行为不同)
真正麻烦的不是装不上,而是装完后 revel new 生成的项目结构里,app/controllers 和 routes 的映射规则默认不暴露任何自定义路由——你得手动改 conf/routes 并在控制器里写 RenderJSON 之类的方法,否则永远只看到欢迎页。


















