revel命令行工具必须安装到$PATH才能调用，推荐用go install github.com/revel/cmd/revel@latest；若提示“command not found”，说明二进制未加入系统路径，需验证which revel和revel version。
revel 命令行工具必须先安装到 $PATH 才能直接调用
直接运行 revel 报 “command not found” 是最常见问题，不是命令写错，而是二进制根本没进系统路径。Revel 的 CLI 不是 Go 模块自动注册的命令，它是个独立可执行文件，必须手动确保它在 $PATH 里。
安装方式已随 Go 生态演进：2025 年后推荐用 go install github.com/revel/cmd/revel@latest，而非旧式 go build -o bin/revel ...。后者生成的二进制默认在 $GOPATH/bin/ 下，但若你没把该路径加进 $PATH，shell 就找不到它。
- 验证是否生效：
which revel应输出路径（如/home/user/go/bin/revel）；revel version能打印版本才说明真正可用 - Windows 用户注意：
go install生成的是revel.exe，命令中无需加 .exe 后缀，但路径需包含%GOBIN%（通常为%GOPATH%\bin） - 如果仍报错 “cannot find package”，大概率是依赖包被墙（如
golang.org/x/net），得手动下载解压到$GOPATH/src/golang.org/x/net，再重试go install
revel run 启动失败多半卡在 -addr 和 -p 参数不匹配
revel run 默认监听 0.0.0.0:9000，但这个行为在 WSL、Docker、Mac M1/M2 或有防火墙的环境里极易失效。错误现象包括：浏览器打不开、curl 连接被拒绝、终端卡在 “Running…” 无日志输出。
根本原因不是 Revel 崩了，而是监听地址和端口没对上。比如你加了 -addr 127.0.0.1 却漏了 -p，Revel 还是会去绑 9000 端口——而该端口可能正被 Chrome 插件或另一个开发服务占着。
- 必须显式指定两者：
revel run myapp -p 8080 -addr 127.0.0.1（开发时推荐用 127.0.0.1 而非 0.0.0.0） - 检查端口占用：
lsof -i :8080（macOS/Linux）或netstat -ano | findstr :8080（Windows） - 容器内运行时，
-addr必须设为0.0.0.0，否则容器网络栈收不到请求；同时宿主机要映射端口，如docker run -p 8080:8080
revel new 创建项目后，config/app.conf 的 http.port 不会自动覆盖命令行 -p
很多人改了 config/app.conf 里的 http.port = 3000，再跑 revel run myapp，结果还是启在 9000 —— 因为命令行参数优先级高于配置文件。-p 是硬覆盖，app.conf 只在没传 -p 时起作用。
这容易造成部署混乱：本地开发用配置文件端口，CI/CD 脚本却靠命令行传参，一旦漏写就回退到默认值。更隐蔽的问题是，revel build 打包后的二进制，启动时完全不读 app.conf 的 http.port，只认运行时参数或环境变量。
- 生产部署务必统一用命令行指定：
./myapp -port 8089 -addr 127.0.0.1 - 若要用配置驱动，得配合环境变量：
REVEL_HTTP_PORT=8089 revel run myapp（部分版本支持，但不如 -p 可靠） -
revel clean会删掉tmp/和imported/，但不会动app.conf；反复revel new时，旧项目的配置残留可能误影响新项目
revel build 和 revel package 的区别远不止名字长短
revel build 和 revel package 都产出可部署的二进制，但目标场景完全不同：前者是调试用的“裸二进制”，后者是带完整资源树的“自包含包”。新手常把 build 出来的文件直接扔进生产环境，结果模板渲染失败、静态文件 404、conf 加载报错。
根本差异在于资源绑定方式。revel build 生成的二进制运行时仍依赖当前工作目录下的 conf/、app/views/、public/ 等目录；而 revel package 会把所有这些资源编译进二进制，并用内部 vfs 加载——这才是真正“一键部署”的方案。
- 开发调试用
revel build，快、轻量、便于 gdb 调试 - 交付给运维或 Docker 镜像用
revel package，执行后生成dist/目录，里面含二进制 +conf/+public/等全套文件 -
revel package不接受-p或-addr参数，端口必须在conf/app.conf里配好再打包，否则运行时报 “no app.conf found”
