revel 框架升级需同步处理 go modules 启用、cli 工具更新、路由注册方式变更及热重载配置。v1.1.0 不兼容 gopath，必须启用 go111module、更新 go.mod 中 revel 依赖为 v1.1.0、使用 ≥v0.25 cli，并将 routes.conf 迁移至 app/init.go 显式注册路由，末尾调用 revel.run()；还需配置 .revelignore 和禁用编辑器原子保存以保障热重载稳定。
Revel 框架升级不是改个版本号就能跑通的事。它没有语义化版本的强约束，也没有官方维护的跨版本升级指南，旧项目升级必须直面目录结构、模块加载、CLI 工具链三者的隐性耦合——尤其当你从 v1.0.x 升到 v1.1.0（当前最新稳定版）时，revel run 命令可能直接报错“not found in GOPATH”，而真实原因其实是 Go Modules 状态或 CLI 版本不匹配。
确认 Go Modules 是否启用且项目已正确初始化
Revel 1.1.0 完全依赖 Go Modules，不再兼容 GOPATH 模式。如果项目仍沿用旧结构（比如放在 $GOPATH/src/... 下），revel run 会静默失败或误判路径。
- 执行
go env GO111MODULE，输出必须是on或空；若为off，需运行go env -w GO111MODULE=on - 检查项目根目录是否存在
go.mod文件；若无，手动执行go mod init github.com/yourname/your-app（路径仅为导入标识，无需真实存在） - 确保
revelCLI 已升级至 ≥v0.25（旧版不识别go.mod）：运行revel version验证
revel CLI 版本与框架版本必须对齐
Revel 的 CLI 工具和框架核心是分离发布的，但行为深度绑定。例如 revel new 在 v0.24 生成的项目结构，无法被 v1.1.0 框架正确加载——它会跳过 app/init.go 中的模块注册逻辑，导致控制器路由 404。
- 升级 CLI：运行
go install github.com/revel/cmd/revel@latest（注意不是@v1.1.0，因为 CLI 最新版已支持框架 v1.1.0） - 验证 CLI 是否识别新框架：在项目根目录执行
revel run .（显式传参.可绕过旧版路径推断逻辑） - 若仍报错
cannot find package "github.com/revel/revel"，说明go.mod中 revel 依赖未更新：手动修改为github.com/revel/revel v1.1.0，再运行go mod tidy
路由与控制器初始化方式变更
v1.1.0 移除了对 routes 目录下 routes.conf 的硬依赖，转而要求所有路由必须在 app/init.go 中通过 revel.InterceptFunc 或 revel.BEFORE 显式注册。旧项目若仍靠配置文件驱动，启动后所有路由将不可达。
- 检查
app/init.go中是否调用revel.Router.Add或revel.Router.AddRoute；若无，需补全 - 原
conf/routes中的GET /api/users Users.Index应转为代码：revel.Router.Add(&revel.Route{Pattern: "/api/users", Method: "GET", Action: "Users.Index"}) - 注意：
revel.Run()必须在init.go末尾调用，否则拦截器和路由不会生效
热重载失效？检查文件监听机制是否适配现代编辑器
Revel 的热重载基于 fsnotify 监听文件变更，但在 VS Code、JetBrains 系列等编辑器中，默认保存行为会触发临时文件写入（如 .swp 或备份文件），导致 revel run 频繁重启甚至卡死。
- 在项目根目录添加
.revelignore文件，写入：*.swp\n*.swo\n.vscode/\n.idea/ - 禁用编辑器的“原子保存”（Atomic Save）选项：VS Code 中设
"files.useExperimentalFileWatcher": false；GoLand 中关闭Use "safe write" - 若仍不稳定，可临时改用
go run main.go手动重启，避免依赖 Revel 的 watch 机制
最易被忽略的是：Revel 不提供自动迁移脚本，所有变更都得手动比对 revel new 生成的骨架项目与你旧项目的 app/、conf/、main.go 差异。别跳过这一步——哪怕只是多了一行 revel.InterceptFunc 调用，漏掉就等于整个中间件链断裂。
