Revel模板中用@url()生成URL,需先在routes中显式命名路由(如as:user.show),再以键值对传参(如'id': 123);查询参数需手动拼接,通配符路由不支持反向生成。

Revel模板里用@url()生成URL,不是拼字符串
硬编码 /user/123/edit 这类链接在Revel里是反模式。路由一改,全项目报错;带参数的更难维护。必须用框架提供的动态生成方式,核心就两个:模板中用 @url(),Go代码里用 c.URL()。
前提是路由必须显式命名——在 conf/routes 里不能只写 GET /user/{id} UserController.Show,得加 as:user.show:
GET /user/{id} UserController.Show as:user.show
然后模板里就能安全调用:
<a href="@url('user.show',%20'id':%20123)">查看用户</a>
-
@url()第一个参数是路由名(as:后面那个),必须完全一致,大小写敏感 - 路径参数用键值对传,比如
'id': 123;多个参数就继续加,如'id': 123, 'tab': 'profile' - 查询参数不支持自动拼接,
@url('user.show', 'id': 123, 'q': 'test')不会生成?q=test—— 得手动追加:@url('user.show', 'id': 123) + "?q=test" - 如果参数值来自模板变量,直接写
'id': .user.Id,不用额外转义
为什么c.URL()在控制器里比@url()更灵活
控制器里用 c.URL("user.show", "id", 123) 是等价的,但优势在于可编程:参数可以来自数据库、计算结果或条件分支,还能做类型检查和错误提前暴露。
常见误用是把整条 URL 当字符串返回再塞进模板,比如:
// ❌ 错误:把URL逻辑下放模板,失去类型安全 c.RenderArgs["editUrl"] = "/user/" + strconv.Itoa(id) + "/edit"
正确做法是只传参数,让框架生成:
// ✅ 正确:参数类型明确,路由变更时编译期报错
c.RenderArgs["editURL"] = c.URL("user.show", "id", id)
-
c.URL()的参数顺序是:路由名,然后交替传 key、value,不支持 map 字面量 - 如果传了不存在的路由名,运行时 panic,错误信息是
no route found for name: xxx,所以命名路由务必统一管理 - 重定向时也优先用它:
c.Redirect(c.URL("user.show", "id", id)),避免302到错路径
通配符路由和动态路径参数的@url()调用限制
像 GET /public/*filepath Static.Serve("public") 这种通配符路由,不能用 @url() 生成——它没命名,也没结构化参数,框架无法反向推导。
这类路径只能手写或封装辅助函数。例如定义一个模板函数:
func PublicURL(filepath string) string {
return "/public/" + filepath
}
然后在 app/init.go 里注册:
revel.TemplateFuncs["publicURL"] = PublicURL
模板里就写 @publicURL("css/app.css")。
- 通配符参数(如
*filepath)不会出现在c.Params的键列表里,@url()根本不知道怎么填 - 动态路由如
/post/{year}/{month}/{slug}可以用@url(),但必须传齐所有占位符:@url('post.show', 'year': 2026, 'month': 10, 'slug': 'how-to-cache') - 不支持可选参数,
{slug}?这种语法 Revel 直接忽略整行路由声明
生成带登录态或权限校验的链接要小心
@url() 和 c.URL() 只管路径,不管权限。如果你在未登录时生成了 /admin/dashboard 链接,用户点开只会看到 404 或重定向到登录页。
真正要控制的是渲染逻辑本身:
- 模板里用
{{if .user.IsAdmin}}@#@#@#@#@#@#@#@#@#@0{{end}} - 控制器里别盲目调用
c.URL(),先检查c.Session.Get("user_id") != nil - 不要试图在 URL 里塞 token 或权限标记,既不安全也不符合 REST 原则
动态链接的本质是解耦路径结构与业务逻辑,而不是绕过访问控制。生成之后是否可点,得由上下文决定,不是链接本身的问题。











