revel 命令找不到是因 GOBIN 或 PATH 未正确配置；需检查并导出 $GOPATH/bin 到 PATH，再验证 revel version；go install 失败则需设置 GOPROXY 或改用 go get + install；项目启动失败多因缺失 conf/app.conf 或编码含 BOM。
revel 命令找不到：PATH 没生效是常见原因
安装 revel 命令行工具后执行 revel version 报错 command not found，基本就是 GOBIN 或 PATH 配置没到位。Go 1.16+ 默认使用 GOBIN 控制二进制输出路径，而 Revel 的 go install 命令会把可执行文件放到 $GOBIN（若未设置则默认为 $GOPATH/bin），但这个目录必须显式加入 PATH 才能全局调用。
- 检查
GOBIN当前值：go env GOBIN；若为空，说明走的是默认$GOPATH/bin - 确认
GOPATH路径：go env GOPATH，比如输出是/home/you/go，那二进制实际在/home/you/go/bin - 把该路径加进系统
PATH：Linux/macOS 编辑~/.bashrc或~/.zshrc，追加一行export PATH="$PATH:$GOPATH/bin"；Windows 在系统环境变量中编辑Path，新增%GOPATH%\bin - 重载配置（Linux/macOS）：
source ~/.zshrc；Windows 需重启终端或命令提示符 - 验证：
which revel（Linux/macOS）或where revel（Windows），应返回具体路径；再运行revel version看是否输出版本号
go install github.com/revel/cmd/revel@latest 失败怎么办
执行 go install 报依赖缺失（如 github.com/revel/config、golang.org/x/net），不是 Revel 本身有问题，而是 Go 模块代理或网络策略拦截了间接依赖。尤其在国内环境，go install 不像 go get 自动处理 replace 和代理配置。
- 先确保 GOPROXY 正常：
go env -w GOPROXY=https://proxy.golang.org,direct（推荐替换为国内镜像，如https://goproxy.cn） - 如果仍失败，临时改用
go get+go install分步：go get github.com/revel/cmd/revel@latest，再go install github.com/revel/cmd/revel@latest - 遇到
import cycle类错误（如golang.org/x/net/websocket循环引用），说明旧版 Revel 与当前 Go 版本不兼容——2025 年后主流已转向 Revel v2（基于 Go Modules 重构），请确认你安装的是github.com/revel/cmd/revel而非已废弃的github.com/revel/revel子模块 - Windows 下若提示
cannot find module providing package，检查是否在项目目录外执行命令；go install应在任意空目录下运行，**不要**在src或revel app目录里执行
revel new 创建项目后，revel run 启动失败提示 missing conf/app.conf
这不是命令行工具配置问题，而是 Revel 运行时依赖配置文件。即使 revel 命令本身能执行，项目启动失败也常被误认为“没装好”。revel new myapp 生成的目录结构里，conf/app.conf 是必需的，但某些旧版脚本或手动拷贝可能遗漏它。
- 确认
myapp/conf/app.conf文件存在；若缺失，从 Revel 官方模板或示例项目中复制一份（最小可用内容只需app.name=myapp和run.mode=dev） - 注意文件编码：Windows 记事本保存的
app.conf可能带 BOM，导致解析失败；建议用 VS Code、Notepad++ 等工具保存为 UTF-8 无 BOM 格式 -
revel run必须在项目根目录（即含app/、conf/的目录）下执行，不能在app/子目录里运行 - 开发模式下端口被占用会静默失败；可加
-port=9001指定其他端口：revel run -port=9001
最易忽略的一点：Revel 的命令行工具和框架运行时是两个独立组件。前者（revel）只负责创建/构建项目，后者（revel/revel 包）才是运行时依赖。即使 revel version 成功，也不能保证 revel run 一定成功——后者还依赖项目内 go.mod 中声明的 Revel 版本是否与命令行工具兼容。v1 和 v2 的 revel build 输出产物结构不同，混用会导致启动崩溃。
