Revel 项目必须用 Go Modules 管理依赖，旧式 GOPATH 模式已彻底失效；只要 go.mod 存在、GO111MODULE 开启、Revel CLI ≥ v0.25，revel run 就能正常解析模块路径。报“not found in GOPATH”是因环境未适配 Modules：GO111MODULE=off、缺失 go.mod 或 Revel CLI 版本低于 v0.25。
Revel 项目必须用 Go Modules 管理依赖，旧式 GOPATH 模式已彻底失效；只要 go.mod 存在、GO111MODULE 开启、Revel CLI ≥ v0.25，revel run 就能正常解析模块路径。
为什么 revel run 报 “not found in GOPATH”？
这不是 Revel 配置问题，而是环境未适配 Go Modules。Revel v0.1x 确实强依赖 GOPATH，但当前（2026 年）主流 Revel CLI（≥ v0.25）和 Revel v1.x 已原生支持 Modules —— 错误只会在以下情况出现：
-
go env GO111MODULE返回off（需设为on或清空） - 项目根目录下没有
go.mod文件（go mod init没执行） - Revel CLI 版本过低（
revel version显示 - 误把项目放在
$GOPATH/src/下并期望旧逻辑生效（Modules 下该路径纯属干扰）
go mod init 的 module path 写什么？
写一个**语义清晰、可导入的路径名**，不需对应物理路径或 GitHub 地址。例如：
go mod init myapp
或
go mod init github.com/yourname/my_revel_app
两者都合法。关键点：
- 路径仅用于
import语句和依赖解析，不影响文件存放位置 - 避免使用
github.com/前缀却无对应仓库——这不会报错，但会误导协作者 - 若后续要发布到私有模块代理，建议用实际域名（如
git.internal.company/myapp）
如何加依赖、更新、锁定版本？
不用特殊命令，所有操作走标准 Go Modules 流程：
- 添加新包：
go get github.com/gin-gonic/gin@v1.9.1（自动写入go.mod） - 更新已有包：
go get -u github.com/sirupsen/logrus（升到兼容最新次版本） - 清理冗余依赖：
go mod tidy（删掉未 import 的 require 行，补全间接依赖） - 验证锁定一致性：
go build成功即表示go.sum与当前依赖完全匹配
⚠️ 注意：revel run 不会自动触发 go mod tidy，必须手动运行，否则新增 import 后可能编译失败。
开发中调试依赖库代码怎么办？
用 replace 指令临时覆盖远程模块，无需发版、无需改 import 路径：
replace github.com/revel/revel => ../revel-dev
或指向 fork：
replace github.com/revel/revel => github.com/yourfork/revel v1.3.0-fix
执行后必须运行：
-
go mod tidy（让 replace 生效并更新go.sum） -
go build验证是否真被替换（检查编译日志里加载的是本地路径）
容易忽略的是：replace 只对当前模块生效，子模块若直接 import 原路径，仍会拉远程版本——所以务必确认所有 import 都经过你主模块的依赖图传递。
