VSCode中npm报EACCES或“command not found”90%非VSCode问题，而是npm全局路径权限受限或终端未加载shell配置：macOS/Linux应执行npm config set prefix ~/.local并添加~/.local/bin到PATH；Windows推荐npm install --user或npx；PowerShell需运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser；终端PATH缺失则通过terminal.integrated.shellArgs设为["-i"]或手动补全PATH。
VSCode 里 npm 报 EACCES 或 “command not found”，90% 不是 VSCode 的问题，而是 npm 全局路径权限或终端环境没加载对。
npm install -g 报 EACCES / Permission denied
错误信息里一定含 EACCES 和 /usr/local/lib/node_modules（macOS/Linux）或 C:Program Files
odejs
ode_modules（Windows），说明 npm 正试图往系统级目录写文件，但当前用户无权操作。
- 别用
sudo npm install -g：它会让 npm 以 root 身份执行 preinstall 脚本，可能删库、改系统配置、污染node_modules权限链 - macOS/Linux 正确解法：
npm config set prefix ~/.local
然后把~/.local/bin加进$PATH：编辑~/.zshrc（macOS Catalina+ 默认 shell 是 zsh），追加一行：export PATH=~/.local/bin:$PATH
再执行source ~/.zshrc - Windows 推荐用
npm install --user替代-g；若必须装 CLI 工具（如vercel），优先试npx vercel启动，避免全局安装
VSCode 终端里 node -v 正常但 npm -v 报错
这说明 Node.js 可执行文件找到了，但 npm 的可执行脚本（比如 npm.cmd 或 npm.ps1）不在 PATH 中，或者 PowerShell 拦截了脚本执行。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 先确认真实路径：
macOS/Linux 执行which npm
Windows 执行where npm
如果返回空，说明 npm 没被系统识别 - PowerShell 场景下常见报错：
xxx.ps1 cannot be loaded because running scripts is disabled
这不是权限问题，是执行策略限制。在 VSCode 终端中运行：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
然后关闭并重开终端（不用重启 VSCode） - 检查 VSCode 是否继承了完整
PATH：
对比系统终端和 VSCode 终端的echo $PATH（macOS/Linux）或echo %PATH%（Windows）
缺了/usr/local/bin（macOS）、C:Program Files odejs（Windows）就坐实是环境变量未加载
VSCode 集成终端不读 ~/.zshrc 或 PATH 扩展失效
VSCode 启动终端时默认不加载 shell 的交互式配置文件（比如 alias、PATH 补充），导致 npm 或自定义 bin 目录不可见。
- 临时修复：在 VSCode 终端里手动执行
source ~/.zshrc（macOS/Linux）或source ~/.bashrc - 永久修复：
macOS/Linux：在 VSCode 设置中搜索terminal.integrated.shellArgs.osx，设为["-i"]（让 zsh 以交互模式启动）
Windows：在settings.json中添加："terminal.integrated.env.windows": { "PATH": "${env:PATH};C:\Program Files\nodejs" } - 如果用了
nvm，确保~/.nvm/nvm.sh已在~/.zshrc中正确source，且没有被return提前中断
Node 安装路径含空格或中文导致 require 失败
VSCode 的 js-debug 调试器对路径编码极敏感。哪怕只是 /Applications/Visual Studio Code.app 这种带空格的路径，也可能触发 Cannot find module；若 Node 安装在中文路径（如 /Users/张三/Downloads/node-v18.17.0-darwin-arm64），require() 会直接失败。
- 执行
which node，确认输出路径是否纯英文、无空格、无中文字符 - 官网 pkg 默认装在
/usr/local/bin/node，没问题；手动解压安装的，务必挪到/usr/local或~/bin这类标准路径 - Windows 用户注意：nvm-windows 默认路径是
D: vm4w odejs，不是C:Program Files odejs，必须把该路径加进 VSCode 的terminal.integrated.env.windows.PATH
最易被忽略的是：VSCode 启动方式影响环境变量加载——从 Dock 或 Finder 启动的 VSCode，其集成终端不会自动读取 shell 的 login 配置；而从终端执行 code . 启动，则会继承当前 shell 环境。调试时建议优先用后者验证。
