根本原因是vscode远程服务进程启动时固化了node和path环境，不读取后续shell配置；npm脚本在资源管理器中执行失败因vscode-server不加载~/.bashrc而只认~/.profile，终端中能运行因走当前shell环境；断点无效多因runtimeexecutable路径未设绝对路径或--inspect绑定127.0.0.1；中文乱码需配置远程服务器utf-8 locale并重启ssh及完全重开vscode。
VSCode 通过 Remote-SSH 连接远程 Node 项目，调试能跑通，但 npm scripts 点击执行失败、断点不触发、控制台输出乱码或缺失——根本原因不是配置漏了，而是 VSCode 的远程服务进程（vscode-server）启动时固化了当时的 node 和 PATH 环境，后续手动改 ~/.bashrc 或用 nvm use 不生效。
为什么 npm scripts 在资源管理器里点不动，但在终端里能跑？
VSCode 的 NPM SCRIPTS 面板由远程端的 vscode-server 启动的独立进程驱动，它不读取你当前终端的 shell 环境，只认启动时加载的 PATH 和 node 路径。而你在集成终端里执行 npm start，走的是你当前 shell 的 nvm 或 export PATH 设置，两者环境完全隔离。
-
vscode-server默认在用户登录时（非交互式 shell）启动，不会 source~/.bashrc或~/.zshrc - 它只读取
~/.profile（Linux）或~/.zprofile（macOS Zsh），且仅限登录 shell 阶段 - 如果你用
nvm，必须把nvm初始化逻辑和node版本固定写进~/.profile，不能只放~/.bashrc - 验证方式：在 VSCode 终端执行
echo $PATH，再断开重连一次，对比两次输出是否一致
launch.json 断点无效？检查这三处硬编码路径
Remote-SSH 下的 Node 调试依赖远程端真实可用的 node 可执行文件路径。VSCode 不会自动帮你找 nvm 切换后的 node，所有路径都得显式指定。
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
-
runtimeExecutable必须设为绝对路径，例如/home/user/.nvm/versions/node/v18.19.0/bin/node，不能写node或~/.nvm/... -
env.NODE_OPTIONS若含--inspect，确保远程服务实际监听的是0.0.0.0:9229，而非127.0.0.1:9229（否则本地无法连接） -
port字段要和node --inspect=0.0.0.0:9229中的端口严格一致；若用--inspect-brk，VSCode 会等待 attach，别误以为卡死 - 常见错误：
Cannot connect to runtime process, timeout after 10000 ms—— 八成是runtimeExecutable指向了不存在的路径，或node版本太低不支持--inspect
远程 node 版本总对不上？别碰 vscode-server 自带的 node
VSCode Remote 会在首次连接时，在 ~/.vscode-server/bin/xxx/ 下部署一套自带的 node（用于运行插件后台服务），但它**不参与你的项目调试或 npm 执行**。你项目用的 node 完全由你自己装、自己管。
- 卸载
vscode-server自带的node没意义，也删不干净；它只影响插件加载，不影响你的代码 - 真正要管的是：确保
which node输出是你想要的版本，并且该路径已写入~/.profile（见上一条） - ARM64 设备（如树莓派）务必下载对应架构的
node二进制包（linux-arm64），别用 x64 包硬跑，会报Exec format error - 如果用
nvm，在~/.profile末尾加：export NVM_DIR="$HOME/.nvm"<br> [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"<br> nvm use --delete-prefix v16.20.2 > /dev/null 2>&1
连接后中文乱码、emoji 显示方块？不是字体问题
这是远程服务器终端 locale 未启用 UTF-8 导致的，VSCode 终端直接继承系统 locale，改本地字体没用。
- 在远程服务器执行
locale -a | grep -i utf8，确认有en_US.utf8或zh_CN.utf8等 UTF-8 locale - 编辑
/etc/default/locale（Ubuntu/Debian）或/etc/locale.conf（CentOS/RHEL），写入：LANG=en_US.UTF-8<br>LC_ALL=en_US.UTF-8
- 重启 SSH 服务：
sudo systemctl restart ssh，然后彻底断开 VSCode 连接再重连 - 验证：重连后在 VSCode 终端执行
locale，输出中LANG和LC_*值应含UTF-8
最易被忽略的点：每次修改 ~/.profile 或 locale 后，必须完全关闭 VSCode 窗口（不只是断开连接），再重新打开并连接，否则 vscode-server 进程仍沿用旧环境。临时改 PATH 或 source .bashrc，对已运行的 remote session 无效。
