如何让Express服务器实时追踪Pug视图模板的变更？

排查方向及解决方案 #

1. 关闭Express视图缓存 #

Express默认在生产环境启用视图缓存，这会导致修改Pug文件后无法实时生效，甚至重启服务也可能残留缓存。

• 开发环境：在Express初始化代码中添加：

  app.set('view cache', false);
  

• 生产环境：部署时必须确保重启服务时彻底清除缓存，使用进程管理器（如PM2）时，执行pm2 delete <应用名>后再重新启动，避免旧进程缓存的视图继续被使用。

2. 清理反向代理/浏览器缓存 #

如果应用前端有Nginx、Cloudflare等反向代理，或者浏览器缓存了页面，后端的更新不会直接反映到前端：

• 反向代理（如Nginx）：临时关闭缓存配置，或在响应头添加Cache-Control: no-cache, no-store强制不缓存；后续可给静态资源添加哈希后缀，实现版本化缓存。
• 浏览器：强制刷新页面（Ctrl+Shift+R / Cmd+Shift+R），或清除对应域名的缓存数据。

3. 清除部署工具缓存 #

使用Docker、CI/CD流水线部署时，旧的构建缓存可能导致新代码无法生效：

• Docker：构建镜像时添加--no-cache参数，避免复用旧缓存层；运行容器时确保挂载的本地卷没有残留旧文件。
• 传统部署：删除服务器上的旧项目目录，重新上传完整的新代码，不要仅增量覆盖文件。

4. 彻底终止旧进程 #

如果旧的Express进程未完全杀死，新服务无法抢占端口，请求仍被旧进程处理：

• Linux/macOS：执行ps aux | grep node找到所有相关Node进程，用kill -9 <进程ID>强制终止。
• Windows：打开任务管理器，结束所有Node.js相关进程后再重启服务。

5. 禁用Pug自身编译缓存 #

Pug默认可能缓存编译后的模板文件，若自定义了编译逻辑也可能触发缓存：

• 检查Pug编译配置，确保禁用缓存：

  const pug = require('pug');
  pug.compileFile('./views/template.pug', { cache: false });
  

• 删除项目中可能存在的Pug缓存目录（如node_modules/.cache/pug）。

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