vscode 本身不提供 node.js 运行时，必须先在系统级安装 node.js（含 npm），再全局安装并配置 pm2，最后通过 orchidfiles/pm2-vscode 扩展连接管理进程；该扩展仅作远程控制界面，不替代命令行操作。
直接说结论：VSCode 本身不提供 Node.js 运行时，必须先在系统级安装 Node.js（含 npm），再通过 pm2 命令行全局安装并配置好 SSH 或本地连接，最后用 orchidfiles/pm2-vscode 扩展把进程管理“拖进编辑器”。跳过系统级 Node 安装或误以为 VSCode 能替代终端执行 pm2，是绝大多数人卡住的第一步。
Node.js 必须装在系统层面，不是 VSCode 插件能解决的
VSCode 是编辑器，不是运行环境。它不能“自带” Node.js，也不能靠某个插件帮你装好 node 或 npm。你得先确认终端里能跑通：
-
node -v和npm -v有输出（比如v16.18.1和8.19.2） -
npm install pm2 -g成功，且pm2 --version可见版本号 - 如果用远程服务器，
ssh user@host能连上，并且那台机器也满足前两点
常见错误现象：装了 VSCode 插件却点不动“启动”按钮，日志面板空白——八成是远程服务器没装 pm2，或者本地 PATH 没把 pm2 二进制路径包含进去。CentOS 8 上尤其要注意 /etc/profile 里是否 export 了 $NODE_HOME/bin，仅改用户级 ~/.bashrc 不够。
pm2-vscode 扩展只负责“连接”和“展示”，不替你部署或启动应用
这个扩展本质是个“PM2 的遥控器”，不是“PM2 替身”。它不会帮你写 ecosystem.config.js，也不会自动把你的 app.js 加进 PM2 管理列表。你得先手动用命令行启动一次：
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 本地开发：在项目根目录执行
pm2 start app.js --name my-api - 远程部署：先
scp代码过去，再 SSH 进去执行同上命令 - 确保
pm2 list能看到该进程，再打开 VSCode —— 扩展才能从pm2 dump或pm2 jlist里读到数据
参数差异影响很大：--watch、--env production、-i max 这些都得在命令行里明确指定，扩展 UI 里没有这些高级选项的表单。它只映射最常用操作：start/stop/restart/logs，其余仍需回到终端补全。
连接远程 PM2 实例时，SSH 配置比插件设置更关键
扩展设置里填的 “Host”、“User”、“Port” 只是表层，真正决定能否连上的，是你的 SSH 认证方式是否被系统认可：
- 用密码登录？VSCode 必须能无交互输入密码（通常不行，会卡住）
- 用密钥登录？确认私钥路径正确，且权限是
600（chmod 600 ~/.ssh/id_rsa），否则 SSH 拒绝加载 - 远程
pm2路径填错（比如填成/usr/local/bin/pm2但实际在/opt/nodejs/bin/pm2）会导致所有操作失败，错误信息通常是command not found: pm2
性能影响很小，但兼容性坑多：CentOS 8 默认用 firewalld，如果远程服务器开了防火墙，pm2-vscode 依赖的 SSH 连接可能被静默拦截，表现就是“连接中…”一直转圈，查 journalctl -u sshd 才能看到拒绝日志。
真正容易被忽略的是：扩展无法接管 pm2 startup 或 pm2 save 这类一次性配置动作。每次服务器重启后，你得先手动运行 pm2 startup 注册服务，再 pm2 save 持久化当前进程列表——这两步做完，pm2-vscode 才能在下次开机后正常显示已恢复的进程。没人提醒你这点，它就永远“空着”。
