Revel框架本地安装不依赖GOPATH,但必须协同Go 1.17+、Go Modules和≥v0.25的revel CLI;需用go install github.com/revel/cmd/revel@latest安装CLI,禁用go get,且GO111MODULE必须为on。

Revel 框架在本地安装已不再依赖 GOPATH,但必须用 Go 1.17+ + Go Modules + revel CLI 三者协同;直接 go get 旧命令会失败或装错版本,必须用 go install 安装最新 CLI。
确认 Go 环境是否达标
Revel v1.1.0(当前稳定版)要求 Go ≥ 1.17,且默认启用 Go Modules。运行以下命令验证:
go version go env GO111MODULE
若输出类似 go version go1.21.6 darwin/arm64 且 GO111MODULE=on,可继续;否则升级 Go 或执行 go env -w GO111MODULE=on。
- Windows 用户注意:PowerShell 中设置环境变量需用
$env:GO111MODULE="on",CMD 用set GO111MODULE=on - Mac/Linux 用户若仍显示
GO111MODULE=auto,说明 shell 配置未生效,检查~/.zshrc或~/.bash_profile是否漏写export GO111MODULE=on - 不要手动设置
GOROOT(除非你改了 Go 安装路径);GOPATH也不再需要——Revel v1.x 不读取它
安装 revel CLI 工具(不是框架本身)
Revel 没有“框架安装”这回事,它是一个项目脚手架工具链。真正要装的是 revel 命令行程序,且必须用 go install:
go install github.com/revel/cmd/revel@latest
完成后运行 revel version,应输出类似 Revel Framework v1.1.0(2022-04-11)。若报 command not found,说明 $GOPATH/bin 未加入 PATH:
- Mac/Linux:检查
echo $PATH是否含$GOPATH/bin,没有就补上export PATH=$PATH:$GOPATH/bin - Windows:在“系统属性 → 环境变量”中将
%GOPATH%\bin加入用户级PATH - ⚠️ 切勿再用
go get github.com/revel/cmd/revel—— 这是 Go 1.16 以前的旧方式,会跳过版本解析,大概率装出不兼容的 v0.x 分支
创建并启动第一个 Revel 项目
任意目录下执行:
revel new -a myapp
该命令会生成标准结构(app/、conf/、public/),并自动初始化 go.mod。接着启动:
cd myapp REVEL_RUNMODE=dev revel run
访问 http://localhost:9000 应见 “It works!”。常见卡点:
- 端口被占:默认用 9000,若失败,改
conf/app.conf中http.port = 8080,再重试 - 静态资源 404:确认文件放在
public/css/app.css,模板里引用路径是/assets/css/app.css(不是/public/) - 页面空白无报错:检查终端是否打印
INFO app Listening on...;若没这行,说明revel run启动失败但没退出,通常因conf/app.conf语法错误(如漏掉=或多空格)
为什么不用 go get 装 Revel?
因为 Revel 的 CLI 工具和框架代码是解耦的:revel 命令只是个生成器和 runner,实际运行时加载的是项目里 app/tmp/main.go 和 github.com/revel/revel 模块。用 go install 能精准控制 CLI 版本,而 go get 会把依赖拉进当前模块,污染 go.mod,且无法指定 @latest。
更关键的是:v1.1.0 的 revel run 会自动识别 Go Modules,但旧版 CLI(如 v0.22)根本不知道 go.mod 存在,会强行去找 GOPATH/src,导致 not found in GOPATH 错误——这个坑现在还常出现在老教程里。


















