VS Code中Node环境未配好导致pm2无法运行，需先验证node -v和npm -v是否可用；若报错则说明PATH未正确继承，Mac/Linux应通过终端启动VSCode以加载shell配置，Windows需检查多版本冲突；pm2须用非sudo方式全局安装并配置npm prefix，开发时需搭配--watch与--ignore实现热重载，VSCode的pm2-vscode扩展建议优先连接本地PM2实例而非远程。
VSCode里Node环境没配好，pm2根本跑不起来
先确认本地有没有可用的 node 和 npm：在 VSCode 终端里执行 node -v 和 npm -v。如果报错“command not found”，说明 VSCode 没读到系统 PATH，或者 Node 本身没装对。
常见坑是：Mac/Linux 用户用 brew 或 nvm 装了 Node，但 VSCode 是从 Dock 或快捷方式启动的，它不继承 shell 的环境变量；Windows 用户则可能装了多个 Node 版本（比如通过 Chocolatey、官网安装包、WSL 里又装了一个），where node 查出来的路径和 VSCode 里实际调用的不一致。
- Mac/Linux：用终端命令
open -a "Visual Studio Code" --args启动 VSCode，确保它加载了 shell 配置（如~/.zshrc） - Windows：右键 VSCode 快捷方式 → “属性” → “起始位置” 改为你的用户目录，或直接从 PowerShell/WSL 中用
code .启动 - 通用验证法：在 VSCode 终端里执行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），再对比你终端里输出的 PATH 是否一致
pm2 要全局安装，但别用 sudo npm install -g pm2
用 sudo 装全局包会导致权限混乱，后续 pm2 start 可能因权限问题写不了日志或 PID 文件，尤其在 macOS 上容易触发“EACCES”错误。
正确做法是让 npm 使用本地前缀管理全局包：
- 执行
mkdir ~/.npm-global - 执行
npm config set prefix ~/.npm-global - 把
~/.npm-global/bin加进 shell 配置文件（如~/.zshrc）：export PATH=~/.npm-global/bin:$PATH - 重启终端或执行
source ~/.zshrc，再运行npm install -g pm2
装完后验证：pm2 --version 应该返回版本号，且 which pm2 输出路径应在 ~/.npm-global/bin/pm2（非 /usr/local/bin/pm2）
开发阶段用 pm2 start 前必须加 --watch 和 --ignore
开发时你不是真要“守护进程”，而是想自动重启 + 避免无限循环重启。默认 pm2 start app.js 不监听文件变化，改完代码得手动 pm2 restart，失去了热重载意义。
关键参数组合：
-
--watch：启用文件监听，但默认监听整个目录，node_modules或dist里文件一变就触发重启，非常卡顿 -
--ignore：必须显式排除干扰路径，例如--ignore "node_modules/**,dist/**,.git/**" -
--env development：方便在代码里用process.env.NODE_ENV区分环境
推荐命令示例：pm2 start src/index.js --name api --watch --ignore "node_modules/**,dist/**,.git/**" --env development
注意：Windows 用户路径分隔符用 /（不是 \），pm2 内部统一处理，硬写反斜杠会解析失败
VSCode 扩展 pm2-vscode 连不上远程 PM2 就别硬连
很多教程教你在 VSCode 里配置 SSH 连接远程服务器上的 PM2，但实际中 80% 的失败都卡在认证环节：密钥权限不对（chmod 600 没做）、ssh-agent 没启动、PM2 没在目标机器上以用户态运行（比如用 sudo pm2 start 启的，普通用户连不上 socket）。
开发阶段建议只连本地 PM2 实例：
- 扩展设置里把
pm2.host留空或填localhost - 确保本地
pm2是你当前用户启动的（pm2 list看 USER 列是不是你） - 如果扩展面板一直显示 “Connecting…”，先在终端执行
pm2 ping，失败就说明 PM2 daemon 没起来，执行pm2 start任意脚本一次即可唤醒
远程管理不是开发刚需，调试阶段强行连远程反而掩盖本地环境问题。等部署到测试机时，再单独用 pm2 deploy 或 CI 流程推，更可控
