VSCode终端报“command not found”根本原因是未加载shell配置导致PATH缺失：macOS/Linux需设terminal.integrated.profiles中shell的args为["-l"]启用登录shell，Windows应重装Node并勾选“Add to PATH”或手动添加路径至系统环境变量。

VSCode终端里node命令报command not found

根本不是VSCode配置错了，是它启动的shell没加载你的PATH。macOS/Linux默认以非登录shell启动终端，跳过~/.zshrc或~/.bash_profile；Windows则是Node安装时漏勾了“Add to PATH”。

• 先在系统终端（不是VSCode里）跑which node（macOS/Linux）或where node（Windows），确认路径真实存在
• macOS/Linux：打开~/.zshrc，检查是否含export PATH="/usr/local/bin:$PATH"（Homebrew装的）或nvm初始化代码；改完必须完全重启VSCode，source ~/.zshrc只对当前终端生效
• Windows：打开“系统属性→环境变量”，把C:\Program Files\nodejs\加到“系统变量”PATH里；若不确定，重装LTS版并**务必勾选Add to PATH**
• 验证方式只有一种：在VSCode内置终端（Ctrl+`）里直接执行node -v，有输出才算真正生效

terminal.integrated.profiles里怎么配args才生效

加"args": ["-l"]是让shell以登录模式启动，强制读取配置文件——但只改配置不重启VSCode等于白设。

Rydberg Agent Node

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

下载

• macOS/Linux：在VSCode设置里搜terminal.integrated.profiles，找到zsh或bash项，在对应profile里加"args": ["-l"]；例如：

  {"zsh": {"path": "zsh", "args": ["-l"]}}

• Windows PowerShell：加"args": ["-ExecutionPolicy", "RemoteSigned"]可绕过脚本策略限制，但更稳妥的是换用Command Prompt作为默认终端（设terminal.integrated.defaultProfile.windows为"Command Prompt"）
• 改完必须完全退出VSCode进程（macOS右键Dock图标选「退出」，Windows任务管理器确认Code.exe已结束），再重新打开
• 别信“重启窗口”（Developer: Reload Window），它不重建终端进程，PATH不会更新

用code-runner插件跑JS脚本却乱码或卡住

它默认命令是node $fileName，不处理编码、模块类型、输入流——尤其在中文路径或ESM项目下大概率失败。

• Windows乱码：在VSCode设置里搜code-runner.executorMap，把javascript对应值改成：node -r utf-8 $fileName
• ESM报Cannot use import statement outside a module：先确保package.json里有"type": "module"，再把executor改成：node --experimental-specifier-resolution=node $fileName
• 遇到process.stdin就假死：code-runner根本不支持交互式输入，要么切到集成终端手动跑node app.js，要么直接用F5调试模式
• 别指望它替代终端——它只是快捷执行器，复杂场景（如监听端口、读取标准输入）一律失效

launch.json里program路径写错导致F5调试失败

VSCode调试器不是靠“当前文件”猜路径，而是严格按program字段指向的绝对路径去执行——写错一个字符就报Cannot find runtime 'node'或断点不命中。

• 单文件调试：用"program": "${file}"，但必须确保当前打开的是.js文件，且该文件能被node直接执行（比如没用import却没设"type": "module"）
• 入口文件不在根目录：显式写全路径，例如"program": "${workspaceFolder}/src/index.js"，别手填相对路径
• ESM项目：除了package.json加"type": "module"，launch.json里还得加"runtimeArgs": ["--experimental-specifier-resolution=node"]
• 别碰runtimeExecutable字段——除非你明确要用nvm切换版本，否则删掉它，让调试器自动找node

最常被忽略的其实是环境变量刷新时机：改完~/.zshrc或系统PATH后，只关终端窗口没用，VSCode进程本身得彻底退出再拉起，否则继承的还是旧环境。