能否限制TypeScript全局类型（如jest）的作用域到指定目录或文件？

核心问题成因 #

将jest、@testing-library/jest-dom配置在主tsconfig.json的compilerOptions.types数组中时，TypeScript会默认把这些包的全局类型声明注入到所有被TS编译识别的文件中，不存在天然的目录/文件级隔离能力，这也是业务文件可直接调用jest API的根本原因。

具体实现步骤 #

1. 移除主配置中的全局Jest类型声明 #

打开项目根目录的tsconfig.json，将compilerOptions.types字段里的jest、@testing-library/jest-dom条目全部删除，彻底阻断这部分类型的全局注入路径。

2. 为测试场景单独注入对应类型（可按项目文件结构选择适配方案） #

方案一：按目录放置独立类型声明文件

适合测试文件集中存放在独立目录的项目：

• 在测试文件所在的专属目录下（比如src/__tests__/）新建一个jest-env.d.ts类型声明文件
• 文件内仅需直接引入对应类型包，不需要做任何全局配置：

// src/__tests__/jest-env.d.ts
import 'jest';
import '@testing-library/jest-dom';

• TypeScript的类型声明遵循目录作用域规则：放在测试目录下的声明，只会给同目录及子目录下的TS文件提供jest全局类型，不会影响其他业务目录的文件类型检查

注意：不要把这个jest-env.d.ts放在项目根目录、或是其他会被主业务tsconfig扫描到的公共类型目录下，否则会重新变成全局生效。

方案二：拆分tsconfig配置适配混排的测试文件

适合测试文件和业务文件同目录混排（比如component.tsx和component.test.tsx在同一个文件夹）的项目：

• 先调整主tsconfig.json的规则，把测试相关文件排除在主业务代码的编译作用域外：

// tsconfig.json（业务代码用的主配置）
{
  "compilerOptions": {
    // ... 保留原有其他配置
  },
  "include": ["src/**/*.ts", "src/**/*.tsx"],
  "exclude": ["**/*.test.ts", "**/*.test.tsx", "**/__tests__/**"]
}

• 新建tsconfig.test.json作为测试场景的专属配置，继承主配置的所有规则，单独加载jest相关类型：

// tsconfig.test.json（测试代码用的配置）
{
  "extends": "./tsconfig.json",
  "include": ["**/*.test.ts", "**/*.test.tsx", "**/__tests__/**"],
  "compilerOptions": {
    "types": ["jest", "@testing-library/jest-dom"]
  }
}

• 调整IDE的TS服务指向：让编辑器识别tsconfig.test.json作为测试文件的类型检查依据，避免测试文件找不到jest类型的问题

预期效果验证 #

• 业务文件component.tsx中编写const mockFn = jest.fn()时，会直接触发TS报错：Cannot find name 'jest'，符合隔离要求
• 测试文件component.test.tsx中编写相同代码时，可正常识别jest、@testing-library/jest-dom的所有API，无类型报错

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