Mocha配合ts-node运行时报Unsupported Args错误如何解决？

你遇到的参数报错通常来自两类场景：一是Mocha版本更新后命令行参数解析规则调整，二是跨平台环境下glob路径、参数分隔符识别异常，将配置项单独写入Mocha配置文件可以规避绝大多数命令行参数解析问题。

• 第一步：先安装所有必要的开发依赖

npm install --save-dev typescript ts-node mocha @types/mocha @types/node

• 第二步：在项目根目录创建.mocharc.json配置文件，填入以下内容（适用于CommonJS规范项目，即package.json没有配置"type": "module"的场景）

{
  "require": ["ts-node/register"],
  "spec": ["./test/**/*.ts"],
  "extensions": ["ts"]
}

• 第三步：修改package.json中的test脚本，简化为以下内容即可

"test": "mocha"

如果你的package.json配置了"type": "module"，或者tsconfig.json的module字段设置为ESNext/ES2020等ES模块标准，需要调整对应配置：

1. 修改.mocharc.json内容为：

{
  "loader": ["ts-node/esm"],
  "spec": ["./test/**/*.ts"],
  "extensions": ["ts"],
  "experimental-modules": true
}

2. 在tsconfig.json中新增ts-node专属配置：

{
  "compilerOptions": {/* 原有配置保持不变 */},
  "ts-node": {
    "esm": true
  }
}

如果上述配置仍然报错，可以用tsx替代ts-node，它对TypeScript的兼容处理更简单，不需要额外配置loader/require：

1. 安装tsx

npm install --save-dev tsx

2. 修改package.json的test脚本为：

"test": "tsx ./node_modules/mocha/bin/mocha ./test/**/*.ts"

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