在使用 commander.js 构建 cli 工具时，子命令（如 `s
Commander.js 的设计遵循“命令作用域隔离”原则：每个子命令（.command() 创建的）拥有独立的选项解析上下文。这意味着你为子命令 s 添加的 -n、-i 等选项，仅对该子命令生效且仅能通过该子命令的实例或其 action 回调参数访问，而不会合并到顶层 cmdr 实例中。
因此，你在 main() 函数中调用 cmdr.opts() 始终返回 {} 是完全符合预期的行为——这不是 bug，而是设计使然。
✅ 正确做法：在 .action() 回调中接收 四个参数（按顺序）：
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- cmd: 第一个位置参数（对应 <cmd>）
- file: 第二个位置参数（对应 <file>）
- options: 解析后的选项对象（推荐首选方式）
- command: 当前子命令实例（即 sCommand），可调用 .opts() 获取相同结果
以下是修复后的代码示例：
async function main() {
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('-e', 'Accepts multiple substitution commands with one command per "-e" appearance.')
.option('-f <file>', 'Expects a file which consists of several lines containing one command each.')
.option('-p, --print', 'Prints the line on the terminal.')
.option('-g', 'Substitutes all instances of the search.')
.action(async (cmd, file, options) => {
// ✅ 正确获取选项：直接使用 options 对象
console.log('Parsed options:', options); // { negate: true, print: false, ... }
console.log('Negate flag:', options.negate); // true（当传入 -n 时）
// ✅ 或者通过子命令实例获取（等效，但不必要）
// console.log('Via command.opts():', this.opts());
// ✅ 业务逻辑中即可基于 options 控制行为
if (!options.negate) {
console.log(`✅ Successfully replaced in ${file}`);
} else {
// 不输出成功提示（满足 -n 需求）
}
// ... 其他替换逻辑
});
// ⚠️ 注意：parseAsync 必须在所有命令定义完成后调用，且只需一次
await cmdr.parseAsync(process.argv);
}
main();? 关键注意事项：
- 不要在 .action() 外部或根命令上调用 .opts() 来读取子命令选项；
- 确保 parseAsync() 在所有 .command() 定义之后执行，否则命令未注册会导致解析失败；
- 若需在 action 外预处理选项（如全局校验），可监听 command.on('option:*') 事件，但通常无此必要；
- Commander v10+ 推荐使用 async/await + parseAsync()，避免回调地狱。
总结：Commander 的选项作用域严格归属子命令，理解并遵循这一模型，是写出健壮 CLI 的基础。你的 -n 标志现在可通过 options.negate 可靠访问，验证逻辑即可正常工作。
