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
views 目录结构或 app.set() 顺序上反复试错。
