先确认node和npm能否在系统终端正常运行，若报“command not found”，说明node未安装或path未配置；windows需检查安装时是否勾选“add to path”，macos/linux可用brew重装；vscode重启后仍无效需完全关闭再重开。
VSCode里Node环境没配好，node 命令直接报错怎么办
先确认 node 和 npm 能否在系统终端（不是VSCode内置终端）里正常运行。如果连终端都找不到命令，说明Node根本没装或PATH没生效——VSCode的内置终端继承的是系统环境变量，它不会自动修复你漏掉的安装步骤。
常见错误现象：command not found: node 或 'node' is not recognized as an internal or external command
- Windows用户：检查是否在安装Node时勾选了「Add to PATH」；若没勾，手动把
C:\Program Files\nodejs\加进系统环境变量Path - macOS/Linux用户：确认
which node有输出；若无，用brew install node（macOS）或对应包管理器重装 - VSCode重启后仍无效？关掉所有VSCode窗口，再重新打开——它只在启动时读取一次环境变量
package.json 的 bin 字段写错，mycli 命令始终不生效
这是最常踩的坑：你写了 "bin": "index.js"，但没加可执行头，也没设文件权限，更没全局链接。
必须同时满足三件事：
-
index.js开头第一行必须是#!/usr/bin/env node（Windows可忽略但建议保留，跨平台一致） -
package.json中的bin字段值要是字符串（单个脚本）或对象（多命令），例如："bin": {"mycli": "./index.js"}，不能写成"bin": "./index.js"（旧版npm容忍，新版会警告且不注册命令） - 本地开发调试时，别直接
npm install -g，用npm link：在项目根目录运行一次，它会把mycli符号链接到全局node_modules/.bin/下
验证方式：终端执行 which mycli，应返回类似 /usr/local/bin/mycli 的路径；若返回空，说明 npm link 没成功或Shell缓存未刷新（可试 hash -d mycli 或新开终端）。
用 commander 解析参数时，--help 不显示自定义选项
不是没写，是没调用 .parse()，或者调用时机错了。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
典型错误写法：program.option('-v, --verbose').parse(); —— 这样只会解析默认 process.argv，但如果你在脚本里做了其他逻辑（比如提前改了 process.argv），就可能漏掉参数。
- 正确姿势：显式传入
process.argv，即program.parse(process.argv) - 如果你用
#!/usr/bin/env node启动，process.argv[0]是node路径，[1]是脚本路径，真正参数从[2]开始——commander默认跳过前两个，不用手动切片 - 子命令必须先
.command()再.option()，否则子命令下的选项不会出现在--help里 - 中文提示？
program.name('我的工具')可改命令名，但帮助文案本身还是英文；如需全中文，得自己重写.on('--help', () => { ... })
VSCode调试CLI时，断点不触发或 process.argv 看不到参数
VSCode默认调试配置跑的是 node index.js，但它绕过了 bin 入口和真实命令行调用链，所以 process.argv 只有两个元素（node路径 + 脚本路径），没有你传的 --verbose 这类参数。
解决方法：改用「启动配置」传参，而不是手敲命令。
- 在项目根目录建
.vscode/launch.json，内容如下：
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Launch CLI",
"skipFiles": ["<node_internals>/**"],
"program": "${workspaceFolder}/index.js",
"console": "integratedTerminal",
"args": ["--verbose", "test"]
}
]
}</node_internals>
这样启动调试时，process.argv 就包含你预设的参数了，断点也能正常命中。注意别用 attach 模式——它监听已运行进程，不适合CLI这种短生命周期程序。
复杂点在于：真实用户用 mycli --verbose test，而调试时你得在 launch.json 里硬编码参数。如果参数组合多，建议写几个不同配置项，或者干脆用终端+debugger语句临时调试。
