正确解法是执行npm config set prefix ~/.local并把~/.local/bin加入path，而非使用sudo；否则会污染系统、破坏权限链，导致后续npm update或yarn出连锁错误。
npm install -g 报 EACCES 怎么办
这不是 VSCode 的 bug，而是 npm 正试图往 /usr/local/lib/node_modules（macOS/Linux）或 C:\Program Files\nodejs\node_modules（Windows）写文件，而你没权限。别用 sudo npm install -g —— 它会让 preinstall 脚本以 root 运行，可能删库、改系统配置、污染权限链。
- macOS/Linux 执行：
npm config set prefix ~/.local，再把~/.local/bin加进$PATH（编辑~/.zshrc或~/.bashrc，加export PATH=~/.local/bin:$PATH，然后source ~/.zshrc） - Windows 推荐优先用
npx vercel这类命令替代全局安装；非装不可时，用npm install --user（装到%APPDATA%\npm），并手动把该路径加进系统环境变量Path - 验证是否生效：新开 VSCode 终端，运行
npm config get prefix和which npm，两者路径应一致且可写
VSCode 终端里 node -v 正常但 npm -v 报错
说明 Node.js 二进制找到了，但 npm 的可执行脚本（比如 npm.cmd 或 npm.ps1）不在 PATH 中，或者被 PowerShell 拦截了。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 先确认真实位置：
where npm（Windows）或which npm（macOS/Linux）；如果为空，说明 npm 文件根本没被识别 - PowerShell 场景下常见报错：
xxx.ps1 cannot be loaded because running scripts is disabled—— 这不是权限问题，是执行策略限制；在 VSCode 终端中运行：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，然后关掉所有终端面板，再按Ctrl+Shift+`新建一个 - 检查 VSCode 是否继承完整
PATH：对比系统终端和 VSCode 终端的echo $PATH（macOS/Linux）或echo %PATH%（Windows）；缺了/usr/local/bin或C:\nodejs就得补
launch.json 调试时报 “Cannot find runtime 'node'”
调试器不读终端 PATH，它走的是独立查找逻辑。哪怕 node -v 在终端里跑得飞快，launch.json 仍可能失败。
- 打开
.vscode/launch.json，确保"type": "node"和"request": "launch"正确 - 显式指定
"runtimeExecutable"，例如："runtimeExecutable": "/usr/local/bin/node"（macOS/Linux）或"runtimeExecutable": "C:/nodejs/node.exe"（Windows） - 项目必须通过
File → Open Folder打开整个文件夹，否则${workspaceFolder}解析会出错 - 如果用了 nvm 或 nvm-windows，调试器不会自动切换 Node 版本，硬编码路径比依赖环境变量更可靠
PowerShell 策略导致 npm run 失败但无报错
package.json 里 "scripts" 被静默中断，常见于 Windows 上的 PowerShell 终端。错误不明显，但 npm start 就是卡住、没输出、断点灰掉。
- 脚本里别写
#!/usr/bin/env node—— PowerShell 忽略 shebang，直接用node server.js显式调用 - 确保
server.js换行符是 LF（Unix 风格），Windows CRLF 可能让某些工具解析失败 - 避免把项目放在
C:\Users\XXX\OneDrive或C:\Program Files下——这些路径受同步服务或 UAC 锁定，移至D:\projects等干净路径再试 - 不要在
scripts里加sudo node server.js，这会让整个npm run流程以 root 运行，风险极高
where node 有输出就停手，却没验证 npm config get prefix 是否可写、没检查 launch.json 是否绕过了 PATH 查找机制、也没确认 PowerShell 策略是否在新终端里真正生效。每一步都得用具体命令验证，而不是看界面有没有红字。
