VSCode TypeScript助手忽略tsconfig.json的exclude字段该如何解决？

问题背景 #

项目基于Vite+Vitest搭建，主tsconfig.json配置如下：

{
    "compilerOptions": {
        "target": "ESNext",
        "lib": ["dom", "dom.iterable", "esnext"],
        "allowJs": true,
        "skipLibCheck": true,
        "esModuleInterop": true,
        "allowSyntheticDefaultImports": true,
        "strict": true,
        "forceConsistentCasingInFileNames": true,
        "noFallthroughCasesInSwitch": true,
        "module": "esnext",
        "moduleResolution": "node",
        "resolveJsonModule": true,
        "isolatedModules": true,
        "noEmit": true,
        "jsx": "react-jsx",
        "types": [
            "vite/client",
            "vite-plugin-svgr/client",
            "node",
            "vitest/globals",
            "@testing-library/jest-dom"
        ]
    },
    "include": ["src", "types", "vitest.ts"],
    "exclude": ["**/*.test.tsx", "**/*.test.ts"]
}

已在VSCode的settings.json中配置：

{
    "typescript.enablePromptUseWorkspaceTsdk": true,
    "typescript.tsdk": "node_modules/typescript/lib"
}

但VSCode仍会对exclude字段中的测试文件抛出类型错误，需求为：要么让VSCode停止检测测试文件，要么让它正确识别配置中的全局变量。

方案一：让VSCode正确应用exclude规则 #

1. 确认VSCode使用的tsconfig文件：点击VSCode右下角的TypeScript版本号，在弹出菜单中选择项目主tsconfig.json，避免VSCode自动加载其他配置文件（如tsconfig.node.json）。
2. 重启TypeScript服务：按下Ctrl+Shift+P（Windows）/Cmd+Shift+P（Mac），输入TypeScript: Restart TS Server，清除服务缓存，使exclude规则生效。
3. 检查路径匹配：确认"**/*.test.tsx", "**/*.test.ts"能覆盖所有测试文件，若测试文件存放在tests/等独立目录，需调整exclude路径为"tests/**/*", "**/*.test.tsx", "**/*.test.ts"。

方案二：为测试文件单独配置tsconfig（推荐） #

不排除测试文件，通过独立tsconfig让测试文件正确识别全局变量，同时不干扰主代码的类型检查：

1. 新建tsconfig.test.json：

{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "types": [
      "vite/client",
      "vite-plugin-svgr/client",
      "node",
      "vitest/globals",
      "@testing-library/jest-dom"
    ]
  },
  "include": ["src/**/*.test.ts", "src/**/*.test.tsx", "vitest.ts"],
  "exclude": []
}

2. 配置VSCode关联测试文件到新tsconfig：在settings.json中添加：

{
  "typescript.tsdk": "node_modules/typescript/lib",
  "typescript.enablePromptUseWorkspaceTsdk": true,
  "typescript.tsconfigPaths": {
    "**/*.test.ts": "${workspaceFolder}/tsconfig.test.json",
    "**/*.test.tsx": "${workspaceFolder}/tsconfig.test.json"
  }
}

3. 确认Vitest配置启用全局变量：在vitest.config.ts中确保globals: true：

import { defineConfig } from 'vitest/config';
import react from '@vitejs/plugin-react';

export default defineConfig({
  plugins: [react()],
  test: {
    globals: true,
    environment: 'jsdom',
    setupFiles: './vitest.ts'
  }
});

4. 重启VSCode的TypeScript服务，测试文件即可正确识别全局变量，主代码也不会被测试文件干扰。

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