VSCode中node命令找不到的根本原因是集成终端未继承shell配置文件（如~/.zshrc）中的PATH，需通过code --new-window从已加载环境的终端启动，或设置terminal.integrated.inheritEnv为true并选对默认shell。
VSCode 里 node 命令找不到？先确认 PATH 和终端继承关系
VSCode 启动的集成终端默认不会自动加载系统 shell 的完整环境变量（比如 PATH），尤其在 macOS 或 Linux 下用 zsh/bash 配置了 nvm 或自定义 node 路径时，node -v 可能报错“command not found”。这不是 VSCode 本身的问题，而是终端上下文没继承到你 shell 的配置。
解决办法很简单：
- 关掉所有 VSCode 窗口，重新从命令行启动：
code --new-window（确保当前 shell 已正确加载node） - 或在 VSCode 设置里搜
terminal.integrated.defaultProfile，选对 shell（比如zsh），再勾选terminal.integrated.inheritEnv（设为true） - Windows 用户注意：如果用的是 PowerShell，确保
npm和verdaccio命令在PATH中，且不是仅限管理员权限安装的全局包
verdaccio 启动后 localhost:4873 打不开？检查端口占用和监听地址
直接运行 verdaccio 默认只监听 127.0.0.1:4873，这意味着它拒绝来自其他设备（比如局域网内同事电脑）的请求，也容易被本地防火墙或杀毒软件拦截。如果你在 VSCode 里用 Live Server 或前端项目访问 http://localhost:4873 失败，大概率是这个原因。
改配置文件 ~/.config/verdaccio/config.yaml，关键两处要改：
-
listen: 0.0.0.0:4873（允许所有 IP 访问，别漏掉0.0.0.0） -
url_prefix: /（确保没加多余路径前缀，否则 Web UI 资源 404） - 改完重启
verdaccio，再用curl -I http://localhost:4873测试是否返回200 OK
npm set registry http://localhost:4873 失效？验证 registry 是否真正生效
执行 npm config set registry http://localhost:4873 后，常有人发现 npm install 还是从官方源拉包——因为 npm 的 registry 配置有层级：全局、用户、项目三级，项目级 .npmrc 会覆盖全局设置。VSCode 终端当前工作目录若含 .npmrc，它就起效了。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
排查步骤：
- 运行
npm config list，看输出里registry行是不是你设的地址（注意缩进对齐） - 运行
npm config get registry，确认返回值 - 检查当前目录是否有
.npmrc，若有，删掉或改里面registry=行 - 装包时加
--verbose参数：npm install lodash --verbose，看日志里实际请求的 URL 是不是http://localhost:4873
VSCode 调试时 npm 包解析失败？别让 verdaccio 和 node_modules 冲突
当你在 VSCode 里用 F5 启动 Node.js 调试（比如 launch.json 中 "type": "node"），如果代码里 require('your-private-package') 报 Cannot find module，通常不是 verdaccio 没起作用，而是 node_modules 目录里压根没装那个包——verdaccio 只管分发，不自动帮你把私有包装进项目。
必须手动触发安装：
- 确保
npm config get registry返回的是http://localhost:4873 - 运行
npm install your-private-package@1.0.0（版本号不能省，私有包一般没 latest tag） - 装完检查
node_modules/your-private-package是否存在，再调试 - 如果用了 pnpm/yarn，记得对应执行
pnpm add或yarn add，它们各自读自己的 registry 配置
最常被忽略的一点：verdaccio 代理上游时，首次请求某个包会缓存到本地 storage 目录，但这个过程是异步的；你刚 publish 完立刻 install，可能因缓存未落盘而 404。等几秒再试，或看 verdaccio 控制台有没有 http 日志。
