vscode便携版不自带node.js，需确保其能正确调用本地已安装的node命令；本质是通过启动脚本注入path（如windows的start.bat、macos/linux的start.sh），使vscode继承node路径，而非修改系统变量或打包node。

VSCode 便携版本身不自带 Node.js 运行时，所谓“配置 Node 环境”，本质是让便携版 VSCode 能正确调用你本地已安装的 node 命令——不是把 Node 打包进去，而是让它找得到、认得准、用得稳。

为什么便携版启动后还是报 “command not found: node”

便携模式只管 VSCode 自身数据（设置、插件、缓存）的存放路径，不接管系统环境变量。哪怕你在 data 目录里放了 node.exe，VSCode 也不会自动把它加进 PATH。它仍然依赖系统级的 node 可执行文件位置。

• Windows 下常见现象：终端里敲 node -v 报错，但 CMD 或 PowerShell 里能正常运行 → 说明 Node 已装，但 VSCode 没继承 PATH
• macOS/Linux 下更隐蔽：VSCode 启动时没加载 ~/.zshrc 或 ~/.bash_profile，导致 export PATH 没生效
• 别指望靠修改 launch.json 或 code-runner.executorMap 绕过这个问题——底层找不到 node，任何上层配置都卡在第一步

便携版下让 VSCode 找到 node 的实操路径

核心思路：不改系统，也不打包 Node，而是让 VSCode 启动时明确知道 node 在哪。最稳的方式是通过 shell wrapper 或启动脚本注入 PATH。

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• Windows：在便携目录（如 D:\vscode-portable）下新建 start.bat，内容为：

  set PATH=C:\Program Files\nodejs;%PATH%
  start Code.exe --user-data-dir="./data" --extensions-dir="./extensions"

  注意路径要和你实际 Node 安装路径一致（比如你装在 D:\nodejs，就写 set PATH=D:\nodejs;%PATH%）
• macOS：新建 start.sh，加上执行权限：

  #!/bin/zsh
  export PATH="/opt/homebrew/bin:$PATH"  # Homebrew 默认路径
  open -a "Visual Studio Code.app" --args --user-data-dir="./data" --extensions-dir="./extensions"

  保存后终端执行 chmod +x start.sh
• Linux：类似 macOS，但用 ./Code 替代 open -a，且 PATH 中加入 /usr/local/bin 或 ~/.local/bin

code-runner 插件在便携环境下容易出什么问题

code-runner 默认直接调用 node，不带路径，也不检查编码。便携场景下它会沿用你启动 VSCode 时的环境，一旦 PATH 注入失败，就会静默失败或输出乱码。

• Windows 中文路径下跑 JS 文件，控制台显示方块或空行 → 加 -r utf-8 参数：

  "node -r utf-8 $fileName"

• ES Module 项目（含 import）报 Cannot use import statement → 改 executorMap：

  "node --experimental-specifier-resolution=node $fileName"

• 用 process.stdin 的脚本（如简单输入提示）直接卡住 → code-runner 不支持交互式 stdin，必须切到集成终端手动运行

便携版真正的难点不在 VSCode 配置，而在于环境变量的“传递链”是否完整：Node 安装路径 → 系统 PATH → VSCode 启动方式 → 插件执行上下文。漏掉任意一环，node 就会消失。别信“解压即用”，每个环节都要亲手验证。