Revel CLI 工具必须用 go install github.com/revel/cmd/revel@latest 安装,不可用 go get 或手动 go build;否则 revel new 会报 command not found 或路径错乱,且需确保 $GOPATH/bin 在 $PATH 中。

Revel 命令行工具必须用 go install 安装,不能靠 go get + go build 手动编译;否则 revel new 会报 “command not found” 或路径错乱。
安装 Revel CLI 工具(不是框架本身)
Revel 的 revel 命令是独立的 CLI 工具,和你的 Go 项目无关。它负责生成项目、启动服务、打包等,必须先全局安装:
- 运行
go install github.com/revel/cmd/revel@latest(Go 1.16+ 要求) - 验证:执行
revel version,应输出类似Revel Framework v1.1.0 - 别用旧式
go get github.com/robfig/revel—— 这个仓库已归档,robfig/revel是历史版本,revel/cmd/revel才是当前维护分支 - 确保
$GOPATH/bin在$PATH中,否则 shell 找不到revel命令
创建并运行第一个项目
命令执行后立刻能访问页面,但有三个关键点决定成败:
- 用
revel new -a myapp创建项目,-a参数不可省略,否则生成目录结构不完整 - 项目生成后直接进目录,运行
REVEL_RUNMODE=dev revel run myapp—— 必须显式设REVEL_RUNMODE=dev,否则默认读[prod]配置,模板不热重载、错误堆栈被隐藏 - 浏览器打开
http://localhost:9000,看到It works!表示成功;若 404,请检查conf/app.conf中http.port是否被占用(Mac/Linux 用lsof -i :9000查)
静态资源路径容易 404?不是代码问题,是访问路径写错了
Revel 把 app/public/ 目录映射到 /assets/ 路径,不是 /public/ 或 /css/:
- 把 CSS 文件放进
app/public/css/app.css - 在模板中写
,不是/css/app.css或/public/css/app.css - 启动后手动访问
http://localhost:9000/assets/css/app.css,返回 200 且内容可读才算通 - 改了
public/下文件不会触发热重载,需手动刷新浏览器 —— 这不是 bug,是设计行为
数据库和会话配置是“隐形门槛”
没配好这两项,应用可能跑起来但一碰表单或登录就 panic:
- 数据库:若用了
models且调c.DB.Insert(),但conf/app.conf没设db.import和db.url,请求直接崩溃;SQLite 零配置方案最稳:db.import = github.com/revel/revel/database/sqlite,db.url = "file:app.db" - 会话:首次运行前必须生成密钥,否则
Session.Set()失效;在conf/app.conf加一行app.session.secret = "your-32-byte-random-string",可用openssl rand -base64 32生成
真正卡住新手的,往往不是语法或逻辑,而是 revel 命令找不到、静态资源 404 却在查模板、或者 session 写进去读不出来却以为是代码问题 —— 这些全是路径、环境变量、配置段落的细节偏差。











