如何解决Testcafe与Jest类型冲突：无法重新声明块级变量'test'

方案1：拆分TS配置（最推荐，彻底解决） #

冲突的根源是项目默认的TS配置会把所有.ts文件（包括你新增的Testcafe测试文件）纳入编译范围，同时加载了Testcafe自带的全局类型定义，和Jest的全局test声明冲突。你可以通过拆分配置，让生产/开发构建时不加载Testcafe相关的类型：

1. 修改根目录tsconfig.json，排除Testcafe测试目录，限制全局类型加载范围：

{
  "compilerOptions": {
    // 保留你原有的其他配置
    "typeRoots": ["node_modules/@types"], // 仅自动加载@types下的类型定义
    "types": [] // 默认不全局注入任何测试类型
  },
  "exclude": [
    "node_modules",
    "tests/testcafe" // 排除Testcafe测试目录，主构建流程不会扫描该目录下的文件
  ]
}

2. 为Testcafe单独创建专属配置文件tests/testcafe/tsconfig.json：

{
  "extends": "../../tsconfig.json",
  "compilerOptions": {
    "types": ["testcafe"] // 仅在Testcafe测试环境下注入Testcafe全局类型
  },
  "include": ["./**/*.ts"]
}

3. 调整Testcafe运行命令，指定专属配置文件：
   把你原有的Testcafe启动命令加上参数：--ts-config-path tests/testcafe/tsconfig.json，示例：
   testcafe chrome tests/testcafe/**/*.spec.ts --ts-config-path tests/testcafe/tsconfig.json

如果Jest测试也不需要加入生产构建，也可以在根目录tsconfig.json的exclude数组里加入Jest测试目录，同时给Jest也单独配专属tsconfig即可。

方案2：临时快速解决 #

如果只是想快速消除报错不影响业务开发，可以在根目录tsconfig.json的compilerOptions中添加配置：

"skipLibCheck": true

该配置会跳过对node_modules下所有.d.ts类型文件的校验，不会影响业务代码的类型检查，无需修改其他配置即可解决冲突。

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