根本不是权限不足，而是VSCode终端未加载用户shell配置导致node和npm路径不一致，使npm link的symlink逻辑崩溃；需确保~/.zshrc正确配置PATH并启用terminal.integrated.shellArgs.osx为["-i"]以加载交互式配置。
VSCode 中 Node 无法创建软链接（ln -s 失败），根本不是权限不足，而是终端没加载用户 shell 配置，导致 node 和 npm 路径不一致，进而使 npm 的 symlink 逻辑崩溃。
为什么 npm link 在 VSCode 终端里报 EACCES 或 ENOENT
现象是执行 npm link 或 npm link package-name 时，提示类似 EPERM: operation not permitted, symlink 或 ENOENT: no such file or directory, symlink。这不是文件系统权限问题，也不是你没写权限——而是 npm 找不到它该用的 node 可执行文件路径，或目标模块路径解析错乱。
- VSCode 终端默认不读
~/.zshrc（macOS）或~/.bashrc（Linux），所以which node返回空，或指向错误位置（如/usr/bin/node） -
npm link内部依赖node的真实路径来构造 symlink 目标；路径错，symlink 就会写到不存在的目录，或尝试在只读路径（如/usr/local/lib/node_modules）里操作 - 即使你改过
npm config set prefix ~/.local，若npm进程本身没加载正确 PATH，它仍会 fallback 到系统默认前缀
检查并修复终端环境加载
先确认问题根源：在 VSCode 终端里运行
which node<br>which npm<br>echo $PATH
如果 node 和 npm 指向不同位置（比如一个来自 Homebrew，一个来自官网 pkg），或 $PATH 里没有 ~/.local/bin，就说明 shell 初始化没生效。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- macOS（zsh）：编辑
~/.zshrc，确保有export PATH=~/.local/bin:$PATH，且没有return提前中断加载 - Windows（PowerShell）：检查
$env:PATH是否包含 Node.js 安装目录（如C:\Program Files\nodejs），并在$PROFILE中追加$env:PATH += ";C:\Program Files\nodejs" - VSCode 设置中启用交互式 shell：搜索
terminal.integrated.shellArgs.osx（macOS）或terminal.integrated.shellArgs.windows（Windows），设为["-i"] - 重启 VSCode（不是 reload window），再新开终端验证
避免 npm link 走系统路径
即使环境变量 OK，npm 仍可能因全局配置残留而试图写入 /usr/local/lib/node_modules。必须确保：
- 运行
npm config get prefix输出是/Users/xxx/.local（macOS）或C:\Users\xxx\AppData\Roaming\npm（Windows） - 若输出是
/usr/local，立刻执行npm config set prefix ~/.local（macOS/Linux）或npm config set prefix %APPDATA%\npm（Windows） - 删除旧的全局 link：手动删掉
~/.local/lib/node_modules/package-name和~/.local/bin/package-name（如有） - 重新
cd到包目录，运行npm link；再cd到使用方项目，运行npm link package-name
WSL 用户特别注意路径挂载层干扰
如果你在 WSL 中开发，且项目放在 /mnt/c/... 下：npm link 会因 NTFS 不支持 symlink 而直接失败（即使加了 --force 也无效）。
- 不要在
/mnt/c下做npm link；把包和项目都移到~/projects/等原生 WSL 路径 - 检查
/etc/wsl.conf是否启用了metadata：应有[automount]<br>options = "metadata"
，否则 chmod/symlink 操作不持久 - 运行
ls -la确认目标目录支持 symlink：输出中应含lrwxrwxrwx类型条目；若全是drwxrwxrwx，说明挂载层屏蔽了符号链接能力
真正卡住的点往往不在 symlink 命令本身，而在 npm 启动时加载的 node 二进制路径是否真实、是否可写、是否跨了挂载边界——这些细节一旦错位，错误信息就会伪装成权限问题。
