如何在yargs中区分空命令与*通配默认命令捕获场景

直接利用yargs的命令匹配优先级规则就能实现，不需要额外手写复杂的参数解析逻辑：

• yargs内置的$0匹配符仅对应用户未传任何子命令、直接调用CLI本身的场景，也就是你要的空命令触发核心逻辑的情况，不会捕获其他带了自定义命令名的输入。
• 把*通配命令放在所有自定义命令的最后注册，它只会命中前面所有规则都没匹配到的未定义命令，刚好用来做兜底的帮助提示/忽略逻辑。
• 建议开启strictCommands()配置，避免位置参数被误识别为命令名，匹配逻辑更可靠。
• 你原有代码漏了hideBin处理启动参数：process.argv默认前两位是node运行路径、脚本文件路径，不做裁剪的话很容易出现命令误匹配问题。

修改后的可直接运行的TypeScript代码：

import yargs from 'yargs/yargs';
import { hideBin } from 'yargs/helpers';
import { getPath } from './parser';
import { ArgumentsCamelCase } from 'yargs';

yargs(hideBin(process.argv))
  // 优先注册根命令：匹配空命令调用场景
  .command({
    command: '$0',
    describe: "Parse a file's contents",
    builder: (yargs) => {
      return yargs.option('i', {
        alias: 'input',
        describe: 'Path to the target file',
        type: 'string',
      });
    },
    handler: (argv: ArgumentsCamelCase<{ input?: string }>) => {
      // 可按需加校验：空命令没传input时直接展示帮助
      if (!argv.input) {
        yargs.showHelp();
        return;
      }
      // 核心业务逻辑写在这里
      console.log('Running core logic, file path:', getPath(argv.input));
    },
  })
  // 最后注册兜底命令：捕获所有未定义的子命令
  .command({
    command: '*',
    handler: () => {
      console.log('Error: Unrecognized command\n');
      yargs.showHelp();
    }
  })
  .help()
  .strictCommands() // 开启严格命令匹配，避免参数被误识别为命令
  .parse();

匹配效果 #

• 执行something --input="../hello.there"：命中$0根命令规则，正常运行核心逻辑
• 执行something xxx（xxx为未定义命令）：命中*兜底规则，输出错误提示+帮助信息
• 执行something help：正常触发内置帮助逻辑，不会被兜底规则捕获
• 执行something无任何参数：按根命令handler里的校验逻辑，直接输出帮助信息

内容的提问来源于stack exchange，提问作者Hyeonseo Kim