不能在Gin模板中直接做设备判断,因服务端渲染无DOM信息;应由后端注入设备标识(如c.Set("IsMobile", true)),前端通过CSS媒体查询和Vue条件渲染实现响应式。

直接在 Gin 模板里做设备判断不可靠,也不推荐。Gin 的 HTML 渲染是服务端一次性完成的,没有运行时 DOM 或屏幕信息;真正的设备适配必须由前端控制,后端只负责提供可被识别的上下文(比如注入设备标记)。
为什么不能在 LoadHTMLGlob 模板里用 JS 判断后再渲染?
你可能会想:在 index.tmpl 里写 <script>if (screen.width < 992) { ... }</script> 动态加载组件 —— 这样做会导致两个严重问题:
- 首屏内容不可见或闪动:JS 执行晚于 HTML 解析,移动端用户先看到桌面版结构,再被 JS 替换,SEO 和用户体验双崩
- 服务端无法缓存差异化内容:CDN、反向代理、浏览器 HTTP 缓存都把
/当作同一个 URL,没法区分 mobile/desktop - 根本绕不开 UA 可伪造、
window.innerWidth在 SSR 场景下为 undefined 等硬伤
正确做法:后端注入设备标识,前端用 CSS + 条件渲染
gin-vue-admin 的 useResponsive 钩子已经做了这件事 —— 它不是在模板里判断,而是在 Vue 初始化阶段读取 document.body.getBoundingClientRect().width,然后设置全局状态。你需要让 Gin 配合这个流程:
- 在
c.HTML()前,调用queryDevice()逻辑(或更稳妥地,从ctx.Request.Header.Get("User-Agent")+ 宽度 hint 推断),存入c.Set("is_mobile", true) - 把该标识透传进模板:
c.HTML(http.StatusOK, "index.tmpl", gin.H{"IsMobile": isMobile}) - 在
index.tmpl中只做最小化标记: - 后续所有响应式行为交给 CSS 媒体查询和 Vue 的
v-if/class绑定,例如:
c.HTML() 渲染时如何避免重复加载模板?
如果你有几十个页面都要做设备适配,别在每个路由 handler 里重复写 queryDevice() + c.Set()。用中间件统一处理:
func DeviceDetectMiddleware() gin.HandlerFunc {
return func(c *gin.Context) {
ua := c.Request.Header.Get("User-Agent")
isMobile := strings.Contains(ua, "Mobile") || strings.Contains(ua, "Android") || strings.Contains(ua, "iPhone")
c.Set("IsMobile", isMobile)
c.Next()
}
}
r := gin.Default()
r.Use(DeviceDetectMiddleware())
r.GET("/", func(c *gin.Context) {
c.HTML(http.StatusOK, "index.tmpl", c.Keys) // 直接透传
})
注意:这里 UA 判断只是兜底,真实项目应结合前端首次访问时上报的 window.innerWidth 存入 cookie 或 localStorage,后端下次请求读取该值,比 UA 更准。
最易被忽略的一点:Gin 的 LoadHTMLGlob 不支持运行时条件编译模板,它只做一次文件加载。所谓“不同设备返回不同 HTML”,本质是同一份 HTML 通过 class 控制显隐,或由前端框架按需挂载组件 —— 后端只管把上下文给干净,别越界。











