如何为Commander.js开发的Node.js CLI应用实现自定义错误提示？

嘿，看你在用Commander.js做这个算术CLI工具，挺有意思的！不过目前你的代码还没覆盖到各种错误场景，比如用户输入非数字、参数不够，或者敲了不存在的命令时，要么没提示，要么用的是Commander默认的生硬提示。我来给你讲讲怎么加自定义错误提示，让你的工具更贴心好用。

一、先梳理要处理的错误场景 #

咱们先列出来常见的几个错误情况：

• 用户使用加减乘除选项时，参数数量不足（比如armath --add 5只给了一个数）
• 用户输入的不是有效数字（比如armath --add five 3）
• 除法时除数为0的情况
• 用户输入了不存在的命令或无效选项

二、一步步修改代码实现自定义提示 #

我基于你的代码改了一版，加了所有错误处理的逻辑，你可以对照着看：

import chalk from "chalk";
import { Command } from "commander";

const program = new Command();

// 自定义错误处理函数，统一提示风格
const showError = (message) => {
  console.log(chalk.red(`❌ 错误：${message}`));
  process.exit(1); // 退出进程并标记错误状态
};

program
  .name("armath")
  .description(`A cli app to perform arithmetic operations`)
  .option("-a, --add <numbers...>", 'Add two numbers')
  .option("-s, --sub <numbers...>", "Subtract two numbers")
  .option("-m, --multiply <numbers...>", "Multiply two numbers")
  .option("-d, --divide <numbers...>", "Divide two numbers")
  // 自定义无效命令/选项的提示
  .on("command:*", () => {
    showError(`未知命令：${program.args.join(' ')}
请使用 armath --help 查看可用命令`);
  });

program.parse(process.argv);
const opts = program.opts();

if (!process.argv.slice(2).length) {
  console.log(chalk.green("Hello World!"));
} else if (opts.add) {
  // 检查参数数量
  if (opts.add.length !== 2) {
    showError("加法需要传入两个数字参数，比如：armath --add 3 5");
  }
  // 转换并检查是否为有效数字
  const [num1, num2] = opts.add.map(str => {
    const num = Number(str);
    if (isNaN(num)) {
      showError(`"${str}" 不是有效数字，请输入数字`);
    }
    return num;
  });
  const sum = num1 + num2;
  console.log(chalk.green(`${num1} + ${num2} = ${sum}`));
} else if (opts.sub) {
  if (opts.sub.length !== 2) {
    showError("减法需要传入两个数字参数，比如：armath --sub 10 4");
  }
  const [num1, num2] = opts.sub.map(str => {
    const num = Number(str);
    if (isNaN(num)) {
      showError(`"${str}" 不是有效数字，请输入数字`);
    }
    return num;
  });
  const diff = num1 - num2;
  console.log(chalk.green(`${num1} - ${num2} = ${diff}`));
} else if (opts.multiply) {
  if (opts.multiply.length !== 2) {
    showError("乘法需要传入两个数字参数，比如：armath --multiply 6 7");
  }
  const [num1, num2] = opts.multiply.map(str => {
    const num = Number(str);
    if (isNaN(num)) {
      showError(`"${str}" 不是有效数字，请输入数字`);
    }
    return num;
  });
  const product = num1 * num2;
  console.log(chalk.green(`${num1} × ${num2} = ${product}`));
} else if (opts.divide) {
  if (opts.divide.length !== 2) {
    showError("除法需要传入两个数字参数，比如：armath --divide 20 4");
  }
  const [num1, num2] = opts.divide.map(str => {
    const num = Number(str);
    if (isNaN(num)) {
      showError(`"${str}" 不是有效数字，请输入数字`);
    }
    return num;
  });
  // 处理除零错误
  if (num2 === 0) {
    showError("除数不能为0，请输入有效的除数");
  }
  const quotient = num1 / num2;
  console.log(chalk.green(`${num1} ÷ ${num2} = ${quotient}`));
}

三、关键实现点说明 #

1. 统一错误提示函数：我写了个showError函数，用chalk把错误标红，还加了emoji让提示更直观，最后用process.exit(1)退出并返回错误状态码，这在CLI工具里很重要。
2. 参数数量检查：每个运算选项都先判断参数是不是正好两个，不够就提示用户正确的用法。
3. 有效数字校验：转换字符串到数字时，用isNaN检查，如果不是数字就直接报错。
4. 除零特殊处理：除法单独加了除数为0的判断，这个是算术运算里的经典错误场景。
5. 无效命令处理：通过Commander的command:*事件，捕获用户输入的未知命令，自定义提示内容，引导用户看帮助。

这样改完之后，你的CLI工具遇到各种错误情况时，都会给出清晰友好的提示，用户体验一下子就上来了！

备注：内容来源于stack exchange，提问作者RedFlame64