在Node.js+Express开发中如何向所有res.render语句传递公共变量

Express本身内置了两种全局注入模板变量的能力，完全不用每个路由手动传值：

方案1：使用 res.locals + 全局中间件（最适合你的购物车场景） #

res.locals是每个请求独立的变量对象，所有该请求触发的res.render都可以直接访问里面的属性，搭配全局中间件就能实现所有路由自动注入。

实现步骤：

• 在你的路由注册之前，添加全局中间件：

app.use(async (req, res, next) => {
  // 初始化默认购物车数量为0
  res.locals.cartCount = 0
  // 如果用户已登录，从数据库/缓存中读取对应用户的购物车商品数量
  if (req.user) { // 可根据自己的登录态获取逻辑调整，比如用req.session.user也可以
    // 示例：从购物车表查询当前用户的商品总数
    const count = await CartModel.sum('quantity', { where: { userId: req.user.id } })
    res.locals.cartCount = count || 0
  }
  next()
})

• 之后所有Pug模板里可以直接使用cartCount变量，不需要在res.render的参数里手动传值：

// 购物车图标旁展示数量的示例代码
div.cart-icon
  span= cartCount

注：该方案每个请求独立计算值，适合用户专属的动态数据，不会出现不同用户数据串掉的问题

方案2：使用 app.locals 注入全局静态变量 #

如果是全站所有用户通用的静态变量（比如网站名称、备案号之类的），可以直接存在app.locals里，一次设置所有模板永久可用：

// 项目启动时设置一次即可
app.locals.siteName = '我的电商站'

所有模板里直接用siteName就能取值，无需重复传递。

优化建议 #

如果购物车数量读取比较频繁，可以存在Session或者Redis缓存里，添加/删除购物车的时候同步更新缓存，不用每次请求都查数据库，提升接口响应速度。

内容的提问来源于stack exchange，提问作者Dan