Revel CLI 不支持 Go Modules，根本原因是其依赖 GOPATH 路径解析；go get 安装失败源于 GO111MODULE=on 时无法解析非 module 化的 CLI 工具，需关闭模块模式安装，且项目必须置于 $GOPATH/src 下才能通过 revel new 创建并正常启动。
revel 命令找不到、go get 报错或安装后无法生成项目，根本原因不是网络或权限问题，而是 Go 模块模式与 Revel 旧版工具链不兼容——Revel CLI 本身不支持 Go Modules，默认仍走 GOPATH 路径解析。
go get 安装 revel CLI 失败（module lookup 错误）
Go 1.16+ 默认启用 GO111MODULE=on，而 go get github.com/revel/cmd/revel 会尝试用模块方式拉取，但 Revel 的 CLI 工具未发布正式 module 版本，导致解析失败或下载空包。
- 临时关闭模块模式：
GO111MODULE=off go get github.com/revel/cmd/revel（Linux/macOS）或set GO111MODULE=off && go get github.com/revel/cmd/revel（Windows CMD） - 确认安装路径：执行
which revel（macOS/Linux）或where revel（Windows），输出应为$GOPATH/bin/revel；若为空，说明没装进 bin 目录，检查$GOPATH/bin是否在$PATH中 - 别用
go install替代go get：Revel CLI 依赖gobuild和go list在 GOPATH 下定位应用，go install生成的二进制缺少运行时路径推导能力
revel new 创建项目报错 “invalid import path”
错误信息类似 invalid import path "myapp" 或 app.conf: no such file or directory，本质是 Revel 无法从当前目录反推出合法的 Go import path，它严格依赖 GOPATH 工作区结构。
- 项目必须建在
$GOPATH/src/xxx/yyy下，例如$GOPATH/src/github.com/yourname/myapp；放在~/Desktop/myapp或./myapp会直接失败 - 验证 import path 是否合法：运行
go list -f '{{.Dir}}' github.com/yourname/myapp，输出应为完整磁盘路径且末尾含/myapp；否则revel new会拒绝创建 - 不要手动改
app.conf里的app.importPath：它必须和你传给revel new的参数完全一致，比如revel new github.com/yourname/myapp→app.importPath = "github.com/yourname/myapp"
revel run 启动时报 “no app found” 或 panic in init()
这类错误往往发生在项目已创建但结构被意外破坏，比如删了 app/ 目录、移动了 conf/app.conf，或 app/init.go 里调用了未初始化的全局变量。
- 检查
app/目录是否存在且含controllers/、views/、models/子目录；Revel 启动时会扫描这些路径，缺一不可 -
conf/app.conf必须存在、UTF-8 无 BOM、首行非空；Windows 记事本另存极易加 BOM，可用file conf/app.conf（Linux/macOS）或 PowerShell 的Get-Content conf/app.conf -Encoding UTF8验证 - 若
app/init.go中有自定义初始化逻辑（如数据库连接），确保它不依赖尚未加载的配置项；Revel 加载顺序是：命令行参数 → 环境变量 →conf/app.conf→app/init.go，过早读revel.Config.String("db.host")会 panic
Windows 上 revel 命令闪退或无响应
不是杀毒软件拦截，而是终端编码或路径分隔符问题。PowerShell 或新版 Windows Terminal 默认用 UTF-8，但 Revel 内部某些日志写法会触发 os.Stdout.Write 对非 ANSI 字符的 panic。
- 换用 CMD 运行：
cmd /c "revel run -a github.com/yourname/myapp"，避免 PowerShell 的 Unicode 处理干扰 - 禁用彩色日志：在
conf/app.conf中设revel.log.color = false，防止 ANSI 转义序列引发输出异常 - 路径中不能含中文或空格：即使 GOPATH 是
C:\Users\张三\go，Revel 解析go list输出时可能截断或乱码，建议 GOPATH 设为纯英文路径如C:\gopath
真正卡住的地方，往往不是命令输错了，而是 GOPATH 结构、import path 和终端环境这三者之间没对齐——尤其当从旧项目迁移或多人协作时，有人用 VS Code 终端、有人用 Git Bash、有人开了模块模式，细微差异就会让 revel 在路径解析阶段静默失败。
