Revel CLI安装失败时应加-x或-v参数查看详细日志，遇cannot find module需切换GOPROXY；revel new/run报错需检查目录结构、权限及PATH；404无路由日志须开启revel.INFO.log = true排查。
revel CLI 安装命令执行后无输出或报错不明确
直接运行 go install github.com/revel/cmd/revel@latest 失败时，Go 不会默认打印依赖拉取的详细过程。错误常被静默吞掉，或只显示 vague 的 build failed。
解决办法是强制开启详细构建日志：
- 加
-x参数看完整编译命令：go install -x github.com/revel/cmd/revel@latest - 加
-v查看模块下载与依赖解析过程：go install -v github.com/revel/cmd/revel@latest - 若提示
cannot find module providing package，说明 Go 模块代理不可达，临时换源：export GOPROXY=https://goproxy.cn,direct（国内）或export GOPROXY=https://proxy.golang.org,direct（海外）
revel new 或 revel run 启动时报 “no such file or directory” 类错误
这类错误不是 Revel 自身日志，而是底层 Go 工具链或文件系统权限问题。关键要看错误里具体缺失的是哪个路径 —— 它往往暴露真实瓶颈。
常见情况和对应检查点：
- 报错含
conf/app.conf: no such file or directory：说明项目未按 Revel 标准结构初始化，revel new myapp未成功生成目录，或你手动创建了项目但漏了conf/子目录 - 报错含
app/tmp/templates: permission denied：Linux/macOS 下当前用户对app/tmp无写权限，用ls -ld app/tmp确认属主，必要时chown -R $USER app/tmp - 报错含
exec: "revel": executable file not found：PATH 未包含 Go 的 bin 目录，确认go env GOPATH并检查$GOPATH/bin是否在 PATH 中（如未加，临时运行export PATH=$PATH:$GOPATH/bin）
revel run 启动后访问 404 且控制台无 “Loaded X routes” 日志
这不是安装失败，但新手常误以为是 CLI 问题。实际是 Revel 应用启动阶段就卡在路由加载环节，而错误被静默忽略 —— 因为 Revel 默认不把路由解析失败当 fatal，只跳过加载。
必须打开 debug 级日志才能看到根因：
- 在
conf/app.conf中添加：revel.INFO.log = true（注意不是revel.DEBUG.log，INFO 级已足够） - 重启
revel run，观察终端第一屏输出：若出现Failed to parse conf/routes: invalid character ...或routes file not found，就定位到具体文件或编码问题 - 特别注意 Windows 记事本保存的
conf/routes常带 BOM，错误信息可能是conf/routes:1:1: illegal UTF-8 encoding
go test 运行 Revel 测试套件时 panic 无堆栈
Revel 的测试框架在 panic 时默认不打印完整调用链，尤其当你用了 revel.TestSuite 的断言方法（如 t.AssertOk()），失败只输出一行 panic: assertion failed。
要看到真实出错位置：
- 在测试函数开头加
revel.DEBUG.Println("starting TestThatIndexPageWorks")，确认是否进入测试流程 - 运行测试时加
-v和-race：go test -v -race -run=TestThatIndexPageWorks - 若仍无堆栈，临时注释掉所有
t.AssertXXX()，改用原生 Go 断言：if !t.Response.StatusCode == 200 { t.Fatal("expected 200, got", t.Response.StatusCode) }，这样 panic 会带完整行号
真正难排查的从来不是报错信息本身，而是 Revel 把很多早期失败（如配置读取、模板编译、路由加载）设为“可恢复”，导致日志安静得像没发生过。盯住启动瞬间的前 3 秒输出，比事后翻 log 文件更有效。
