VSCode终端能运行node -v但npm报错，是因为未继承shell的PATH环境变量；macOS/Linux需检查~/.zshrc等配置文件是否导出npm路径，Windows需确认系统PATH包含C:\Program Files\nodejs，且必须彻底退出VSCode后重启才能生效。

node -v 能跑，但 npm install ejs 报错找不到 npm

根本不是 npm 没装，是 VSCode 内置终端没继承 shell 的 PATH。macOS/Linux 下检查 ~/.zshrc 或 ~/.bash_profile 是否导出了 npm 所在路径（通常和 node 同级，比如 /opt/homebrew/bin）；Windows 则确认系统环境变量里 C:\Program Files\nodejs\ 在 “系统变量 > PATH” 中。改完必须彻底退出 VSCode（关窗口不算），再从终端执行 code . 启动——否则改了也白改。

res.render() 报错 Cannot find module 'ejs'

常见于三类情况：

OC SSH Tunnel Node Recovery

诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。

下载

• 没在项目根目录运行 npm install ejs（不是全局安装 npm install -g ejs）
• package.json 里没生成 "ejs" 条目，或装到了 devDependencies 里（应放在 dependencies）
• Express 初始化时没设模板引擎：app.set('view engine', 'ejs') 和 app.set('views', './views') 缺一不可，且 ./views 目录必须存在

修改 .ejs 文件后页面不更新，必须重启服务

这是默认行为，不是 bug。Express 不自带热重载，需手动集成 nodemon：

• 本地安装：npm install --save-dev nodemon
• 在 package.json 里加脚本："scripts": {"dev": "nodemon ./app.js"}（假设入口是 app.js）
• 终端运行 npm run dev，而非 node app.js
• 注意：VSCode 调试时别直接配 runtimeExecutable 指向 nodemon，断点会失效；改用 attach 模式更稳

渲染出的 HTML 里中文乱码或样式丢失

本质是响应头缺失或静态资源路径错：

• 确保设置了响应类型：res.set('Content-Type', 'text/html; charset=utf-8')（虽 Express 默认带，但显式写更保险）
• 静态文件（CSS/JS）要用 express.static 中间件挂载，比如 app.use(express.static('public'))，然后 .ejs 里引用 <link rel="stylesheet" href="/style.css">，路径以 / 开头
• 如果用了子路由（如 app.use('/admin', router)），静态资源中间件必须在它之前注册，否则 /admin/style.css 会 404

EJS 渲染本身极轻量，但模板路径、编码、静态资源挂载这三点一旦错位，错误信息往往不直接指向根源，容易在 views 目录结构或 app.set() 顺序上反复试错。