在NPM Monorepo中，如何让IntelliJ IDEA正确识别Vitest全局TS类型？

我有一个使用Vitest的NPM Workspaces包，tsconfig.vitest.json配置如下：

{
  "$schema": "https://json.schemastore.org/tsconfig.json",
  "extends": "./tsconfig.app.json",
  "include": ["vite.config.ts", "vitest.config.mts", "tests/**/*.ts", "tests/**/*.js"],
  "exclude": [],
  "compilerOptions": {
    "composite": true,
    "outDir": "../../dist/out-tsc",
    "lib": [],
    "types": ["vitest/globals", "vitest/importMeta", "vite/client", "node"]
  }
}

该包本地未安装Cypress或Jest，但邻包存在Cypress，且Jest是全局peer依赖。我不想手动import { vi, expect, test, describe } from 'vitest'——这正是配置"types": ["vitest/globals"]的目的。但仅本地安装了Vitest的情况下，IntelliJ无法正确解析这些全局类型，我该如何解决？

补充环境信息：TypeScript版本≥5.0，IntelliJ采用Vue Language Server（Volar）进行编译，不确定这是否和.spec.ts文件有关。

可能的原因及解决方法 #

• 全局Jest类型优先级冲突：作为全局peer依赖的Jest，其类型定义可能覆盖了Vitest的全局类型。TypeScript会优先加载更高优先级的类型，即使你没有在本地安装Jest。
  解决：在tsconfig.vitest.json的compilerOptions中，将"vitest/globals"放在types数组最前面，同时添加"exclude": ["jest"]强制排除Jest类型：

  "compilerOptions": {
    // 保留原有配置
    "types": ["vitest/globals", "vitest/importMeta", "vite/client", "node"],
    "exclude": ["jest"]
  }
  

• IntelliJ未关联正确的tsconfig：IntelliJ可能自动使用了根目录或其他tsconfig文件，而非专门的tsconfig.vitest.json来处理测试文件。
  解决：

  1. 打开File > Settings > Languages & Frameworks > TypeScript
  2. 在TypeScript Compiler区域，点击配置文件选择按钮，选中当前包的tsconfig.vitest.json
  3. 或者右键tsconfig.vitest.json文件，选择Mark as > Test TypeScript Configuration

• Volar服务接管了TS文件处理：即使Volar主打.vue文件支持，它的TypeScript服务可能全局接管了所有.ts文件的类型检查，导致Vitest全局类型未被正确注入。
  解决：在项目根目录创建volar.config.js，限制Volar仅处理.vue文件：

  module.exports = {
    features: {
      "vue-template": true,
      "typescript": false // 关闭Volar对非Vue文件的TS处理
    }
  }
  

• NPM Workspaces类型路径混乱：邻包的Cypress可能干扰了TypeScript的类型查找路径，导致无关类型被加载。
  解决：在tsconfig.vitest.json中添加typeRoots，明确指定类型加载路径：

  "compilerOptions": {
    // 保留原有配置
    "typeRoots": ["./node_modules/@types", "./node_modules/vitest/types"]
  }
  

• IDE或TypeScript缓存问题：旧的缓存可能导致类型定义未更新。
  解决：

  1. 执行npx tsc --clearCache清除TypeScript缓存
  2. 在IntelliJ中点击File > Invalidate Caches...，选择Invalidate and Restart重启IDE

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