使用arg包致IntelliJ中Jest测试报错：未知选项--colors

问题根因 #

IntelliJ在启动Jest测试时，会自动给Node进程追加--colors参数，而你的脚本在模块加载阶段就直接执行了main(process.argv)，这时候process.argv里包含了IDE注入的--colors，但你的arg参数配置里没定义这个选项，所以触发了ArgError。

解决方案 #

1. 仅在直接运行脚本时自动执行main（推荐）

修改源码，让main(process.argv)只在脚本被直接执行时才运行，被测试用例引入时不自动执行。用Node的require.main === module判断执行场景：

// 你的main函数定义
function main(argv: string[]) {
  const args = arg({
    '--dry-run': Boolean,
    // 其他参数配置
  }, { argv });
  // 业务逻辑
}

// 仅在直接运行脚本时执行main
if (require.main === module) {
  main(process.argv);
}

export default main;

这样测试用例里手动调用main(["--dry-run"])时，不会触发模块加载时的自动执行，也就不会用到带--colors的process.argv。

2. 让arg忽略未知参数

如果需要保留模块加载时的自动执行，可以给arg添加allowUnknown: true配置，忽略未定义的选项：

const args = arg(
  {
    '--dry-run': Boolean,
    // 你的参数配置
  },
  { 
    argv,
    allowUnknown: true // 忽略未知参数
  }
);

注意：这种方式可能会隐藏真正的参数错误（比如用户输入拼写错误的选项），需谨慎使用。

3. 修改IntelliJ的Jest运行配置

打开IntelliJ的「Run/Debug Configurations」，找到你的Jest配置：

• 在「Options」区域，去掉--colors参数；
• 或者添加--no-colors参数，覆盖IDE的默认设置。

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