在 commander.js 中，子命令的选项不会保存在根命令对象上，而是绑定到对应子命令实例；需通过 action 回调的第四个参数（子命令对象）或第三个参数（自动注入的 options 对象）获取，而非调用 `program.opts()`。
Commander.js 的设计遵循“作用域隔离”原则：每个子命令（如 s
✅ 正确做法是在 .action() 回调中直接接收选项参数。Commander 会自动将解析后的选项对象作为第三个参数传入（按顺序：
cmdr
.command('s <cmd> <file>')
.description('Modifies a string, by first selecting a target file.')
.option('-n, --negate', 'Prevents a line from being printed unless specified by "-p".')
.option('-i', 'Forces sed to edit the file instead of printing to the standard output.')
.option('-g', 'Substitutes all instances of the search.')
// ... 其他 option
.action(async (cmd, file, options) => {
// ✅ 正确：options 是当前子命令解析出的选项对象
console.log('Parsed options:', options); // { negate: true, i: false, g: false, ... }
if (options.negate) {
console.log('Negate mode enabled — suppressing output.');
// 跳过成功提示等默认输出
}
// 执行替换逻辑...
});⚠️ 注意事项：
- 不要调用 cmdr.opts() 或 cmdr.negate —— 它们属于根命令，与子命令无关；
- 不要在 .action() 外部（如 main() 函数末尾）尝试读取选项，此时解析尚未完成或上下文错误；
- 确保 cmdr.parseAsync(process.argv) 在定义完所有命令和选项后仅调用一次，且位于最外层（如你代码中的位置是正确的）；
- 如果需访问子命令实例本身（例如检查原始参数或执行高级操作），可使用第四个参数：.action(async (cmd, file, options, sCommand) => { console.log(sCommand.opts()); })。
? 小技巧：启用调试模式快速验证选项是否被识别
在启动前添加环境变量，查看 Commander 内部解析日志：
DEBUG=commander:* node app.js s foo/bar file.txt -n
总结：Commander 的选项作用域严格按命令层级划分。牢记「子命令选项 → 子命令 action 参数」这一路径，即可避免 opts() 返回空对象的困惑。你的 CLI 将能可靠响应 -n 等标志，并据此控制输出行为。
