答案是windows path被追加到wsl2的$path末尾且终端未加载~/.bashrc所致；vscode默认启动non-login shell跳过配置文件，导致优先匹配/mnt/c/下的windows版node.exe，需设terminal.integrated.shellargs为["-l"]并重启终端，在~/.bashrc中剥离/mnt/路径后重置path。
为什么 which node 在 VSCode 终端里返回 /mnt/c/Program Files/nodejs/node.exe
这不是 Node 没装，而是 Windows 的 PATH 被追加到了 WSL2 的 $PATH 末尾，VSCode 启动的集成终端又默认走 non-login shell，跳过了 ~/.bashrc，导致优先匹配了 Windows 下的 node.exe——它根本不能在 Linux 环境运行。
验证方式：在 VSCode 终端执行 echo $PATH | tr ':' '\n' | grep mnt，如果输出大量 /mnt/c/... 路径，就确认被污染了。
-
terminal.integrated.shellArgs必须设为["-l"]（小写 L），强制启动 login shell，才能加载~/.bashrc - 必须关闭所有已打开的集成终端面板（不只是关标签页，要点右上角 × 彻底关闭）
- 重启后按
Ctrl+`新建终端，再检查$PATH是否干净 - 如果仍不生效，检查
~/.bashrc开头是否有[[ -n $ZSH_EVAL_CONTEXT ]] && return类防护逻辑，临时注释掉
如何在 ~/.bashrc 中安全重置 PATH 顺序
光靠 export PATH="/usr/bin:/bin:$PATH" 不够——Windows 路径可能仍插在中间。得先剥离，再重建。
在 ~/.bashrc 开头（确保早于其他 PATH 修改）加入：
export PATH=$(echo $PATH | tr ':' '\n' | grep -v '^/mnt/' | tr '\n' ':' | sed 's/:$//')
然后显式补回必要路径：
export PATH="/usr/local/bin:/usr/bin:/bin:$PATH"
- 这条命令会过滤掉所有以
/mnt/开头的路径，避免 Windows 工具干扰 - 不要把
node安装到/mnt/c/下；WSL2 内原生安装（如用curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -） - 装完后执行
hash -r刷新命令缓存，再跑which node确认指向/usr/bin/node
项目路径放在 /mnt/c/ 下会导致 npm install 卡住
不是网络慢，是 WSL2 的 9P 协议对小文件 I/O 延迟极高——node_modules 里成千上万个文件，每次 stat 或 open 都要穿越虚拟化层，延迟常达 300–500ms/次。
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
确认方式：在项目目录下运行 df -T .，如果 Type 列显示 9p，就说明踩坑了。
- 正确做法：把源码复制到 WSL2 原生路径，比如
~/projects/myapp - 只复制源码和配置文件（
package.json、.gitignore等），跳过node_modules和构建产物 - 进新目录后直接
npm install，依赖会落在 ext4 文件系统上，速度正常 - 然后在 WSL2 终端里执行
code .（确保已装 Remote-WSL 插件）
code . 在 WSL2 终端里报 command not found 怎么办
根本原因是 Windows 端的 code 命令没注册进 WSL2 的 PATH，或者注册路径没被正确翻译。
先在 Windows PowerShell（管理员）中运行：
code --install-server
再执行：
wsl --shutdown
重启 WSL2 后检查：
-
which code应该返回/usr/bin/code（这是 WSL2 自动创建的 wrapper） - 如果返回空，手动把 Windows 的 VSCode bin 目录加进
~/.bashrc：export PATH="$PATH:/mnt/c/Users/YourName/AppData/Local/Programs/Microsoft VS Code/bin" - 别用
ln -s硬链code.cmd到/usr/local/bin——这会绕过路径翻译机制，后续打开文件夹失败 - 改完记得
source ~/.bashrc，再试code .
真正麻烦的不是哪一步做错，而是多个问题叠加：PATH 污染 + 项目放错路径 + locale 编码未设 UTF-8，三者一起出现时，git 提交乱码、npm 卡死、断点灰掉，看起来像环境崩了，其实只是路径没理清。
