必须设好 GOPATH 且 $GOPATH/bin 要进 PATH，否则 revel 命令根本找不到；Revel v1.x 要求 Go 1.19+，项目必须置于 $GOPATH/src/github.com/yourname/myapp 下，revel run 才能正确解析路径与配置。
必须设好 GOPATH 且 $GOPATH/bin 要进 PATH，否则 revel 命令根本找不到——这不是可选项，是 Revel 运行时路径解析的硬依赖。
Go version 和 GOPATH 是否就绪？
Revel v1.x 要求 Go 1.19+，但真正卡住安装的往往不是版本号，而是环境变量没对齐：
-
go version必须能输出类似go version go1.21.6 darwin/arm64的结果；若报 command not found，说明 Go 二进制没进 PATH -
go env GOPATH必须返回一个**非空、无空格、无中文**的绝对路径（如/Users/you/go或C:\Users\you\go）；若为空，需手动设置 -
echo $PATH（macOS/Linux）或echo %PATH%（Windows）里必须包含$GOPATH/bin（Linux/macOS）或%GOPATH%\bin（Windows）
为什么 GOPATH 不是“可选”，而是 Revel 的路径锚点？
Revel 的 revel new、revel run 全程依赖 GOPATH 来定位：app.conf 加载、模板扫描、import path 解析、甚至临时编译生成的 main.go 都基于 $GOPATH/src 下的包路径。它不支持模块模式下的任意路径启动（不像 Gin 可以 go run main.go 直跑）。
- 项目必须放在
$GOPATH/src/github.com/yourname/myapp这类结构下，revel run -a github.com/yourname/myapp才能正确解析目录 - 若把项目建在
~/Desktop/myapp，即使go mod init成功，revel run仍会 panic：空导入路径或找不到 conf/app.conf - Windows 用户特别注意：
%GOPATH%若含空格（如C:\Program Files\go），会导致fork/exec ... no such file or directory错误，重装 Go 到C:\go级路径最稳
PATH 没加 $GOPATH/bin 的典型表现
执行 go install github.com/revel/cmd/revel@latest 成功后，revel version 却报 command not found——这就是 PATH 缺失的铁证。
- Linux/macOS：运行
export PATH="$PATH:$GOPATH/bin"，并写入~/.zshrc或~/.bash_profile - Windows：系统属性 → 高级 → 环境变量 → 在“系统变量”中找到 Path → 新建 → 填入
%GOPATH%\bin - 验证方式：新开终端，直接输
revel，有帮助信息即成功；再输revel version看输出是否含v1.x.x
最容易被忽略的是：revel new 和 revel run 的行为都隐式依赖 GOPATH 下的源码布局，而不是当前 shell 所在目录。哪怕你 cd 进了项目根目录，只要它不在 $GOPATH/src/... 里，命令就会静默失败或报错——这种路径耦合不是 bug，是 Revel 的设计前提。
