根本原因是vscode远程会话默认使用非登录shell，不加载~/.bashrc等配置文件，导致path缺失；需在~/.bashrc中硬编码path、重启vscode-server并确保nvm环境已激活。
Remote-SSH 连接后 node 命令不可用？先查 PATH 和远程 shell 初始化
VSCode 通过 Remote-SSH 连上服务器后，终端里能执行 node -v，但 NPM SCRIPTS 面板点不起来、调试器报错“command not found”，大概率不是没装 Node，而是 VSCode 的远程会话没加载你 shell 的环境变量。
原因在于：VSCode 启动远程 server（vscode-server）时，默认用的是非交互式、非登录式 shell（如 /bin/sh -c），它不会 source ~/.bashrc 或 ~/.zshrc，也就读不到你用 nvm 或手动配置的 PATH。
- 检查远程终端里
echo $PATH和which node，记下实际路径（比如/home/user/.nvm/versions/node/v14.21.3/bin/node） - 打开远程机器的
~/.bashrc（或~/.zshrc），确认nvm加载和PATH追加逻辑存在且未被if [ -z "$PS1" ]; then return; fi类判断提前退出 - 在
~/.bashrc开头加上：export PATH="/home/user/.nvm/versions/node/v14.21.3/bin:$PATH"（硬编码路径最稳，尤其对旧项目） - 重启 VSCode 远程连接（断开再重连），或运行命令
Remote-SSH: Kill VS Code Server on Host强制重建 server
launch.json 中 type: "node" 调试失败？注意端口、进程模式和工作目录
远程调试 Node.js 服务时，常见错误是 Cannot connect to runtime process 或断点不命中，根本原因是 VSCode 没法正确 attach 到目标进程，而不是代码本身问题。
关键点不在“怎么写配置”，而在于“谁启动了 Node 进程”：
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 如果用
npm start启动（即node ./index.js），必须确保启动命令加了--inspect=0.0.0.0:9229（不是默认的127.0.0.1），否则 VSCode 从远程无法访问调试端口 -
launch.json里"request": "attach"模式下，"port"必须与启动参数一致；"address"字段可显式设为"0.0.0.0"（某些旧版 Node 需要） -
"cwd"必须指向远程项目根目录（绝对路径，如"/home/user/my-project"），不能写相对路径或本地路径 - 避免用
"request": "launch"直接启动——它会在远程起一个新进程，但该进程的PATH和环境变量极可能和你终端里不一致
远程 NPM SCRIPTS 面板不响应？本质是 vscode-server 绑定的 Node 版本滞后
你用 nvm use 14.21.3 切换成功，终端里 node -v 正确，但点击 NPM SCRIPTS 里的 start 仍报错“unsupported version”，说明 VSCode 的后台服务（vscode-server）启动时缓存了旧 Node 路径，之后不再刷新。
这不是 bug，是设计行为：server 一旦启动，就固定使用首次探测到的 node 可执行文件路径。
- 不要依赖“重启 VSCode 窗口”——必须彻底杀死远程 server：
Remote-SSH: Kill VS Code Server on Host（命令面板调出） - 杀完后，重新连接前，先在远程终端手动执行一次
nvm use 14.21.3 && node -v，确保当前 shell 环境已生效 - 再连接，VSCode 会重新探测
node路径，此时才真正绑定新版本 - 若仍失败，直接在
~/.vscode-server下删掉bin目录（它会自动重建），强制重装 server
Windows 本地连 Linux 远程主机时，ssh 密钥认证总失败？别跳过 ssh-agent 配置
填了 host、user、端口，点连接却卡在密码输入或直接报 Permission denied (publickey)，十有八九是 Windows 上的 OpenSSH 客户端没把私钥交给 agent。
VSCode 的 Remote-SSH 插件底层用的就是系统 ssh，它不管理密钥，只调用 ssh 命令。
- 确认私钥文件权限：Windows 上用 PowerShell 运行
icacls ~/.ssh/id_rsa /reset，再设为仅当前用户可读（icacls ~/.ssh/id_rsa /grant:r "$env:USERNAME:(R)"） - 启动
ssh-agent并添加密钥：Get-Service ssh-agent | Set-Service -StartupType Automatic; Start-Service ssh-agent; ssh-add ~/.ssh/id_rsa - 检查是否生效：
ssh-add -l应输出密钥指纹；ssh -T git@github.com能通，Remote-SSH 就一定行 - VSCode 设置里禁用
remote.ssh.useLocalServer（设为false），避免它绕过系统 ssh-agent
