离线安装Node.js依赖需在有网机器执行npm ci生成确定性node_modules并完整拷贝，而非npm install --offline；必须确保源目机Node/npm版本一致、架构匹配，并验证二进制可执行性。
离线安装 Node.js 依赖不是靠 npm install --offline，而是靠提前预下载 + 正确路径映射 —— npm 本身没有真正的离线模式，所谓“离线”全靠你把依赖文件和配置提前搬进去。
怎么提前下载好 node_modules 并迁移到离线机器
npm install 默认联网拉包，离线时必须在有网机器上完成全部依赖解析与下载。关键不是“复制 package.json”，而是复制整个 node_modules 目录结构，且要确保：
- 源机器和目标机器的
node -v和npm -v版本一致（尤其注意 npm v6/v7/v8 对 lockfile 格式兼容性） - 执行
npm install前先运行npm ci（而非npm install），它严格按package-lock.json安装，不写新 lock，避免版本漂移 - 如果项目用了
optionalDependencies或 native 模块（如fsevents、sqlite3），需在目标系统架构（Windows/macOS/Linux + x64/arm64）上构建，不能跨平台直接拷贝
如何让离线 VSCode 识别并使用本地 node_modules
VSCode 本身不管理 node_modules，但插件（如 ms-vscode.vscode-typescript-next、esbenp.prettier-vscode）会读取项目内或全局的依赖。常见问题不是“找不到模块”，而是路径没对齐：
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 确认
settings.json中没误配"typescript.preferences.importModuleSpecifier": "relative"等触发网络请求的选项 - 若用 ESLint 插件，检查
"eslint.packageManager"是否设为"npm"，且"eslint.nodePath"指向离线机器上的 Node 可执行路径（如/usr/local/bin/node） - 打开命令面板（
Ctrl+Shift+P），输入Developer: Toggle Developer Tools，在 Console 里搜Cannot find module，能快速定位是哪个插件在找哪条路径
离线环境下调试 Node.js 的关键配置点
VSCode 调试器（node-debug）本身不依赖网络，但启动前会校验 node 和 npm 可执行文件是否存在。容易被忽略的是：
-
launch.json中的"runtimeExecutable"必须填绝对路径（如"C:\Program Files\nodejs\node.exe"），不能只写"node"—— 离线机器 PATH 可能没设或不一致 - 如果用了
nodemon或ts-node，它们的二进制文件也得一并拷过去，并在launch.json的"runtimeArgs"里指定完整路径 - 某些插件（如
ms-python.python）会尝试从 CDN 下载 Pylance LSP，虽不影响 Node 调试，但会卡住输出面板；可临时禁用非必要插件再测试
为什么 npm install --offline 总是失败
因为 npm install --offline 不是“断网也能装”，而是“跳过远程 registry 查询，只查本地缓存”。而默认情况下，npm 缓存（~/.npm）只存 tarball，不存解压后的 node_modules。所以：
- 它要求你之前在同一台机器上成功运行过
npm install，且缓存未被清理 - 它无法处理
preinstall脚本、git 依赖、file:协议路径等需要实时解析的场景 - 真正可靠的离线方案永远是：
npm ci→ 打包node_modules→ 拷贝 → 修改PATH和settings.json→ 验证require.resolve('xxx')在终端中是否返回路径
最常被跳过的环节是验证 node_modules 里的二进制是否真的能在目标系统跑起来——比如 esbuild 的可执行文件名带平台后缀（esbuild-linux-64），拷错架构就静默失败。
