VSCode终端本身不能直接运行pm2，必须先确保系统级Node.js和pm2已安装并正确配置PATH；否则会出现命令未找到或日志空白。需在VSCode终端执行node -v、npm -v、pm2 --version验证可用性，失败则重装Node（勾选Add to PATH）或修复全局bin路径，nvm用户须重启VSCode加载新环境。
VSCode终端本身不能直接“运行pm2”，必须先确保系统级Node.js和pm2已就绪，否则所有操作都会卡在命令未找到或空白日志上。
确认 node 和 pm2 在 VSCode 终端里真能用
VSCode 内置终端（Ctrl + `）只是复用你的系统 shell 环境，它不会帮你装 node 或 pm2。常见失败点就在这里：
- 在终端里执行
node -v和npm -v，没输出？说明 Node.js 没装或 PATH 没生效——重装 Node.js 并勾选 “Add to PATH” -
pm2 --version报错？说明npm install pm2 -g没成功，或全局 bin 路径（比如/usr/local/bin或%APPDATA%\npm）没进 PATH - 用
nvm管理 Node 版本？改完默认版本后要重启 VSCode，否则终端可能还用旧环境
在 VSCode 终端里正确启动一个 Node.js 应用
别依赖插件 UI 或右键菜单，先用命令行跑通最简路径：
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 确保你在项目根目录（有
app.js或package.json的地方），终端提示符路径要对 - 最基础启动：
pm2 start app.js—— 不加任何参数，只验证能否拉起进程 - 带名字和环境：
pm2 start app.js --name api --env production，名字用于后续操作（如pm2 restart api） - 集群模式（多核）：
pm2 start app.js -i max，但注意：应用代码得是无状态的，且监听端口不能硬编码冲突
pm2-vscode 扩展不是“自动部署工具”
装了 orchidfiles/pm2-vscode 插件后，如果面板空、按钮灰、点不动，大概率是因为：
- 远程服务器没装
pm2，或本地终端连不上那台机器（SSH 配置、密钥、防火墙） - 你没手动用命令行执行过
pm2 start，插件只能读取已注册的进程列表（来自pm2 dump或pm2 jlist） -
--watch、--ignore-watch、--max-memory-restart这类参数，插件 UI 完全不提供输入框，必须写进命令行或ecosystem.config.js - 插件不处理
ecosystem.config.js的加载逻辑——你改了配置文件，仍需手动pm2 reload ecosystem.config.js或pm2 delete all && pm2 start ecosystem.config.js
容易被忽略的权限与路径细节
尤其在 CentOS/RHEL 或 Windows 上，PATH 和用户环境差异会直接导致 pm2 启动失败：
- CentOS 8+：仅修改
~/.bashrc不够，pm2常驻进程由 systemd 启动，需确保/etc/profile或/etc/profile.d/下有export PATH=$PATH:$NODE_HOME/bin - Windows：全局安装的
pm2二进制实际在%APPDATA%\npm\pm2.cmd，若 PowerShell 执行策略禁止脚本，会静默失败——改用 CMD 或临时设Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 日志路径默认在
~/.pm2/logs/，但如果你用sudo pm2 start，日志会落在 root 用户目录下，普通用户进不去，也看不到
