TypeScript构建排除指定文件及本地测试兼容问题求助

嘿，针对你提出的两个TypeScript相关问题，我整理了实用的解决方法，希望能帮到你：

1. 如何仅在TypeScript构建环节排除特定文件？ #

TypeScript默认的tsconfig.json里的exclude是全局生效的，会影响所有TypeScript操作（包括本地类型检查、测试）。如果只想在构建阶段排除文件，推荐这两种方案：

• 使用多tsconfig配置文件
  专门创建一个用于构建的配置文件（比如tsconfig.build.json），继承主配置的基础设置，再单独添加构建需要的排除规则。示例：

  // tsconfig.build.json
  {
    "extends": "./tsconfig.json",
    "exclude": ["**/*.test.ts", "**/*.spec.ts", "src/__tests__/**"]
  }
  

  构建时指定这个配置文件即可：

  tsc --project tsconfig.build.json
  

  本地开发、测试用主tsconfig.json，构建用专门的配置，完美实现场景分离。

• 通过构建工具过滤文件
  如果你用Webpack、Vite、Rollup这类构建工具，可以直接在工具配置里设置忽略测试文件。比如Webpack可以在module.rules中添加exclude规则：

  module.exports = {
    module: {
      rules: [
        {
          test: /\.tsx?$/,
          exclude: /\.test\.tsx?$/,
          use: 'ts-loader',
        },
      ],
    },
  };
  

  这样构建工具会自动跳过测试文件，无需修改TypeScript的全局配置。

2. 仅在构建时排除测试文件，本地nodemon运行测试的解决方法 #

你遇到的Cannot find name 'describe'错误，根源是主tsconfig.json里的exclude把测试文件排除了——TypeScript不会对被排除的文件做类型检查，自然也不会加载@types/jest提供的全局类型定义。解决核心就是分离开发/测试和构建的tsconfig：

1. 调整主tsconfig.json
   移除exclude里的测试文件规则，只排除构建产物文件夹（比如dist），确保TypeScript能识别测试文件并加载对应的类型：

   // tsconfig.json
   {
     "compilerOptions": {
       // 你的基础配置
       "types": ["jest"] // 可以显式添加jest类型，确保全局识别
     },
     "exclude": ["dist"]
   }
   

   别忘了确保已经安装了@types/jest：

   npm install --save-dev @types/jest
   

2. 创建构建专用的tsconfig.build.json
   继承主配置，再添加测试文件的排除规则，和第一个问题里的配置一致：

   // tsconfig.build.json
   {
     "extends": "./tsconfig.json",
     "exclude": ["**/*.test.ts", "**/*.spec.ts", "src/__tests__/**"]
   }
   

3. 配置nodemon和构建命令

   • nodemon运行测试时，默认会使用主tsconfig.json，因为测试文件没有被排除，TypeScript能正常识别jest类型，不会报错。
   • 构建时用tsc --project tsconfig.build.json，这样只会编译非测试文件到产物目录。

这样就实现了「构建排除测试文件，本地测试正常运行」的需求，同时解决了类型报错的问题。

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