必须用 revel run 启动而非 go run，因 Revel 依赖 import path 解析和 app.conf 配置；项目须置于 $GOPATH/src/github.com/yourname/myapp 下，执行 revel run -a github.com/yourname/myapp -p 9000 并访问 localhost:9000。
要在本地快速启动并调试 Revel 框架的示例项目，必须绕过直接调用 go run 的常见误区，因为 Revel 的运行时依赖 import path 解析和 conf/app.conf 中的路径配置，硬编码路径或错误工作区位置会导致空导入路径异常并立即退出。
确认项目位于 $GOPATH/src 下的合法路径
Revel 严格按 Go 工作区模型定位 app.conf、app/ 目录和模板资源；若项目放在 C:\myapp 或 ~/Desktop/revel-demo，即使设置了 GOPATH，revel run 也无法识别应用根目录。【项目路径必须形如 %GOPATH%\src\github.com\yourname\myapp】
执行命令验证当前路径是否合规：go list -f '{{.Dir}}' github.com/yourname/myapp，输出应为完整磁盘路径，且末尾含 \myapp（Windows）或 /myapp（macOS/Linux）。
用 revel run 启动开发服务器
方法一：在项目根目录下执行（确保已安装 revel CLI）：
revel run -a github.com/yourname/myapp -p 9000
该命令会自动加载 conf/app.conf 中的 app.importPath，并启动热编译服务；浏览器访问 http://localhost:9000 即可看到“It works!”页面。注意：-a 参数必须是完整的 import path，不是 . 或 ./，也不是相对路径。
方法二：通过环境变量覆盖配置（适用于调试特定模式）：
REVEL_RUNMODE=dev revel run -a github.com/yourname/myapp -p 9000 -addr 127.0.0.1
这能强制启用开发模式并绑定回环地址，避免被局域网其他设备意外访问；【-addr 127.0.0.1 是调试阶段的安全前提，漏写可能导致端口暴露】
调试控制器逻辑的三步操作
第一步：在控制器方法开头插入 revel.INFO.Printf("进入 Show 方法，ID=%s", c.Params.Get("id"))
第二步：保存文件，观察控制台是否实时打印日志——热编译生效即说明 revel run 正常监听文件变更。
第三步：触发请求（如访问 /product/show/123），检查终端输出是否包含你插入的日志行；若无输出，说明路由未匹配或控制器未被调用，此时需核对 routes 文件中对应 GET 路径是否拼写正确、是否遗漏冒号（如 :id）、是否大小写与控制器名一致。
这一步操作起来很简单，直接把日志语句加到方法第一行就行，但它是验证执行流最轻量的方式。
查看运行时错误堆栈的快捷方式
当浏览器显示“500 Internal Server Error”页面时，不要只看网页提示；立刻回到终端窗口，向上滚动查找以 ERROR 开头的行，它会精确指出出错文件、行号及 panic 原因，例如：ERROR 2026/10/16 10:15:22 product.go:47: invalid memory address or nil pointer dereference。
Revel 在开发模式下会把完整堆栈输出到终端而非隐藏，这是调试的核心信息源；如果终端没有 ERROR 行，说明问题不在服务端，而是前端 JS 报错或网络请求被拦截。
