根本原因是Node.js全局路径、shell环境与权限未对齐；需确保which npm与npm config get prefix路径一致，PATH包含全局bin目录，插件配置匹配终端Node路径，并清理损坏的全局缓存。
VSCode 里 npm install -g 后命令仍找不到，或全局包执行卡顿、报 Cannot find module，根本原因不是 VSCode 没装好，而是 Node.js 全局路径、shell 环境、权限三者没对齐——尤其在 macOS/Linux 用 nvm 或 Windows 用 nvm-windows 时，错配概率极高。
确认 npm 全局路径是否被 VSCode 终端识别
VSCode 终端启动时固化 shell 环境快照，nvm use 后不重启终端，which npm 可能还指向旧版本的 /usr/local/bin/npm，而新安装的全局包实际在 ~/.nvm/versions/node/v20.15.0/bin 下。
- 在 VSCode 终端运行
which npm和npm config get prefix，两个路径必须一致（如都指向~/.nvm/versions/node/v20.15.0） - 若不一致：执行
nvm use v20.15.0后，按Ctrl+Shift+P→ 输入Terminal: Reload Shell Environment刷新环境变量 - Windows 用户用
nvm-windows时，务必以管理员身份运行终端再执行nvm install和nvm use，否则全局 bin 目录权限不足，软链接会失效
PATH 中全局 bin 目录是否真被加载
npm install -g 安装的可执行文件（如 eslint、typescript）放在 prefix 下的 bin/ 子目录，但 VSCode 终端未必把它加进 PATH。
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 运行
echo $PATH，检查输出中是否包含~/.nvm/versions/node/v20.15.0/bin（macOS/Linux）或C:\Users\XXX\AppData\Roaming\npm（Windows） - 若缺失：在 shell 配置文件（
~/.zshrc或~/.bash_profile）末尾添加export PATH="$(npm config get prefix)/bin:$PATH"，然后source ~/.zshrc - VSCode 不读取 shell 配置的“自动启动”模式（比如从 Dock 点开），必须从终端执行
code .启动，才能继承完整PATH
全局模块缓存损坏导致 require 失败
全局安装的包如果依赖本地 node_modules（比如 eslint 依赖 eslint-plugin-react），而这些依赖被意外删过或缓存校验失败，就会在运行时报 Cannot find module 'xxx'，即使 which eslint 能找到命令。
- 先清理全局缓存：
npm cache clean --force - 再重装关键全局工具：
npm install -g eslint typescript prettier - 验证模块加载：
node -e "console.log(require('eslint').version)"—— 若报错，说明eslint自身的node_modules损坏，需删掉$(npm config get prefix)/lib/node_modules/eslint再重装
插件调用全局命令时路径隔离
VSCode 插件（如 ESLint 扩展）默认不复用你终端的 PATH，而是走自己的 Node.js 进程 + 独立环境。它可能用内置 Node 或用户指定的 node.runtimePath，完全绕过你的全局安装。
- 打开插件设置，搜
eslint.node或typescript.node，确认路径指向和终端一致的node可执行文件 - ESLint 插件若提示 “Cannot find module ‘eslint’”，优先检查
eslint.packageManager设置是否为npm，而非yarn或pnpm（它们的全局路径不同） - 禁用所有插件后，在终端手动跑
eslint .成功，但插件里失败 → 问题 100% 出在插件环境隔离，不是全局安装本身
最常被忽略的是：全局包加载慢往往不是网络或磁盘问题，而是 require() 在解析时反复回溯 node_modules 目录树——尤其当 prefix 路径里嵌套了多个 node_modules（比如 ~/.nvm/versions/node/v20.15.0/lib/node_modules/eslint/node_modules 下又有子依赖），Node.js 的模块查找算法会逐层向上找，路径越深越慢。所以别只盯着安装速度，要盯 require.resolve('eslint') 返回的最终路径是否干净、扁平。
