remote-ssh 连接后 node/npm 不可用，主因是 vs code 默认以非登录 shell 启动，未加载 ~/.bashrc 等配置；需修改 ~/.profile 强制 login shell，并正确安装匹配架构的 node（如 arm64），配置 npm 全局镜像，调试时绑定 0.0.0.0 并配准端口转发与 remoteroot 路径。
能连上服务器 ≠ 能跑 Node 项目——Remote-SSH 连接后 npm 报错、node 命令找不到、NPM SCRIPTS 点不动，90% 是远程环境没真正生效。
为什么 SSH 连上了，node 还是报 command not found
VS Code Remote-SSH 启动时默认用 /bin/sh 启动服务，不自动加载 ~/.bashrc 或 ~/.zshrc，所以你手动装的 node、加的 PATH 全部失效。
- 在远程终端里执行
echo $PATH，大概率看不到你放node的路径（比如~/local/bin） -
which node返回空，但~/node-v20.11.0-linux-arm64/bin/node其实存在 - VS Code 的「NPM SCRIPTS」面板和调试器启动时，根本没读你的 shell 配置
解决办法不是反复重装 Node，而是让 VS Code 的远程会话「真正进入你的 shell 环境」：
- 打开远程终端 → 执行
echo 'export PATH="$HOME/local/bin:$PATH"' >> ~/.bashrc（假设你把node软链到了~/local/bin） - 再执行
echo 'exec bash -l' >> ~/.profile（强制每次登录都以 login shell 启动） - 断开连接，重新 Connect to Host —— 这次终端一打开就该有
node -v了
下载错架构的 Node 包导致 cannot execute binary file
树莓派、Mac M1/M2、AWS Graviton 实例全是 ARM64（aarch64），但 VS Code 默认可能下 x64 包，远程解压后运行直接报错。
- 先确认远程 CPU 架构：
uname -m→ 返回aarch64就别下-x64.tar.xz - 去 https://www.php.cn/link/0c9097d0139751fc728f1614cca51b43 找对应版本的
-linux-arm64.tar.xz（不是-linux-x64.tar.xz） - 下载后解压：
tar -xf node-v20.11.0-linux-arm64.tar.xz - 建软链：
ln -sf ~/node-v20.11.0-linux-arm64/bin/node ~/local/bin/node，同理链npm
如果已经下错且 vscode-server 卡住，直接删掉远程 ~/.vscode-server 再重连——它会在新连接时重试下载匹配架构的 server 二进制。
npm install 失败或超慢，镜像没生效
远程机器没配 npm 镜像，所有包都走 registry.npmjs.org，国内基本失败或卡死；更隐蔽的是：VS Code 的「NPM SCRIPTS」面板根本不读你终端里 npm config 的设置。
- 在远程终端运行：
npm config set registry https://registry.npmmirror.com - 验证：
npm config get registry应返回镜像地址 - 关键一步：把配置写进全局级（不只是当前用户）：
npm config --global set registry https://registry.npmmirror.com - 如果用了
nvm，确保nvm use后再设镜像，否则切换版本后配置丢失
注意：yarn 需单独设镜像：yarn config set registry https://registry.npmmirror.com，它不继承 npm 配置。
远程调试时 attach 失败，端口映射没对上
Node 进程绑定了 127.0.0.1:9229，VS Code 本地无法直连，必须靠 SSH 端口转发，但配置稍错就连接拒绝。
- 启动 Node 调试模式：
node --inspect=0.0.0.0:9229 index.js（注意是0.0.0.0，不是127.0.0.1） - 本地开 SSH 隧道：
ssh -L 9229:localhost:9229 user@remote-ip（保持这个 terminal 不关） -
launch.json中："address": "127.0.0.1"，"port": 9229，"localRoot"和"remoteRoot"必须严格一致（含大小写、结尾斜杠） - 常见坑：
remoteRoot写成/home/user/project，但实际路径是/home/user/project/（少斜杠）→ 断点全失效
最易忽略的点：VS Code Remote-SSH 的「Remote Explorer」里看到的文件路径，和你在终端 pwd 输出的路径，可能因挂载方式不同而有隐藏差异——建议全程用绝对路径，且 remoteRoot 末尾加 /。
