Revel框架安装应使用go install github.com/revel/cmd/revel@latest，确保Go 1.19+、GOPATH及PATH配置正确；创建应用用revel new -a myapp -r，访问http://localhost:9000验证。
Revel 框架安装失败，八成卡在 go get 或 revel 命令上——不是 GOPATH 没设对，就是国内网络导致依赖拉不全。直接用 go install + 官方最新路径是当前最稳的路。
确认 Go 环境和 GOPATH 是否就绪
Revel 依赖 Go 工具链和明确的工作区路径，GOPATH 不只是可选配置，而是框架生成、编译、运行的根目录。Windows/macOS/Linux 都必须确保：
-
go version能正常输出（建议 Go 1.19+，Revel v1.x 对 Go 1.21 兼容良好） -
GOPATH已设置且$GOPATH/bin在PATH中（否则revel命令找不到） - 不要把项目放在
GOROOT下，所有 Revel 应用必须建在$GOPATH/src或模块模式下的任意路径（但命令行工具仍需GOPATH支持）
用 go install 安装 revel 命令行工具（推荐）
旧式 go get github.com/robfig/revel/revel 已失效（仓库迁移、模块弃用），现在必须用新路径：
go install github.com/revel/cmd/revel@latest
执行后检查是否成功：
revel version
输出类似 Revel Framework v1.1.0 (2022-04-11) 即可。若提示 command not found，说明 $GOPATH/bin 没进 PATH，Linux/macOS 运行：
export PATH="$PATH:$GOPATH/bin"
Windows 用户请将 %GOPATH%\bin 加入系统环境变量 Path。
创建并运行第一个 Revel 应用
不用手动 mkdir 或 git clone，revel new 会自动生成标准 MVC 结构：
revel new -a myapp -r
参数说明：
-
-a myapp：应用名，会生成$GOPATH/src/myapp目录（或模块路径下同名文件夹） -
-r：创建完立即运行，等价于后续执行revel run myapp
启动后访问 http://localhost:9000，看到 Revel 默认欢迎页即成功。注意：
- 开发模式默认监听
0.0.0.0:9000，公网服务器务必改用-addr 127.0.0.1启动 - 首次运行会自动下载依赖到
$GOPATH/pkg，若卡住，大概率是golang.org/x/...包被墙，需配代理或换源（如 GOPROXY=https://goproxy.cn）
常见报错与绕过方法
以下错误出现频率最高，对应解决动作要精准：
-
revel: command not found→ 检查which revel或ls $GOPATH/bin/revel*，缺失就重跑go install -
cannot find package "github.com/revel/revel"→ 不要手动import这个旧包，Revel v1.1+ 已统一用github.com/revel/revel（注意没有robfig） - 启动时报
template: ...: no such template→ 多因app/views路径被误删或大小写错误（如Views），Revel 对路径名敏感 -
panic: runtime error: invalid memory address在app/init.go→ 常见于未调用revel.InterceptFunc或插件注册顺序错，先注释掉自定义拦截器排查
Revel 的“约定大于配置”体现在路径、命名、初始化顺序上，少一个 AppInit 函数或错放一个 conf/app.conf，整个应用就起不来——这不是 bug，是设计前提。动手前先扫一眼生成的 app/init.go 和 conf/routes 结构，比查文档更快定位问题。
