如何配置TypeScript使其仅检测测试文件并忽略其他文件？

DevOps 小满

2026-4-28

解决Jest测试中Node Modules类型警告的TS配置方案

嘿，这个问题我之前碰到过！本质就是要让TypeScript只检查你写的测试文件，别去碰项目里的JS代码和node_modules里的第三方依赖，这样就能彻底解决那些来自组件库的prop type警告了。下面分两步来配置：

1. 精准控制`tsconfig.json`的检查范围

直接修改你的tsconfig.json，把检查范围严格限定在测试文件上，同时排除所有不需要管的内容：

{
  "compilerOptions": {
    // 保留你原本的编译选项（比如target、module这些）
    "noEmit": true, // 我们只做类型检查，不需要生成JS文件，开这个能提速
    "skipLibCheck": true // 关键！跳过第三方库的类型定义检查，直接干掉node_modules的类型报错
  },
  "include": [
    "**/*.test.ts", // 匹配所有后缀为.test.ts的测试文件
    "__tests__/**/*.ts" // 如果你的测试都放在__tests__目录下，加上这个
  ],
  "exclude": [
    "node_modules",
    "src/**/*.js", // 排除项目里所有JS文件
    "src/**/*.jsx" // 有JSX的话也一起排除
  ]
}

这里划重点：

skipLibCheck: true是核心，它会让TypeScript跳过所有@types包和第三方库的类型检查，直接解决那些来自node_modules的prop type警告。
include只写测试文件路径，确保TS只盯着你的测试代码看，其他一概不管。

2. 给Jest也做个配置（用ts-jest的话）

如果你的Jest用ts-jest处理TS测试，得让Jest也别去碰node_modules里的代码，在jest.config.js里加这些：

module.exports = {
  // 保留你原本的Jest配置
  transformIgnorePatterns: ["/node_modules/"], // 忽略node_modules的代码转换
  moduleFileExtensions: ["ts", "js", "json"],
  testMatch: [
    "**/*.test.ts",
    "__tests__/**/*.ts"
  ]
};

这样Jest运行测试时，就不会去处理第三方依赖的代码，自然不会触发那些烦人的警告了。