Vite+Vue项目tsconfig.node.json引入工具文件引发TS报错求助

问题根源 #

vite.config.ts 默认关联 tsconfig.node.json（Node环境配置），而src目录下的文件关联主项目的tsconfig.json。当vite.config.ts引用src文件时，会触发两个配置的类型检查冲突：

• 未将src文件加入tsconfig.node.json的include时，TS报ts(6307)（文件不在项目列表）
• 加入后，两个配置都试图处理该文件生成d.ts，导致ts(6305)（输出文件冲突）

实际构建正常是因为Vite构建逻辑不依赖IDE的TS静态检查，仅为IDE类型校验错误。

方案一：给vite.config.ts单独配置tsconfig #

1. 在项目根目录新建tsconfig.vite.json，内容如下：

{
  "extends": "./tsconfig.node.json",
  "include": ["vite.config.ts", "src/utils/example.ts"],
  "compilerOptions": {
    "noEmit": true // 禁止生成输出文件，避免与主配置冲突
  }
}

2. 在vite.config.ts顶部添加注释，指定使用该配置：

// @tsconfig: ./tsconfig.vite.json
import { defineConfig } from 'vite'
import { ... } from './src/utils/example'

// ... 配置内容

方案二：修改tsconfig.node.json，禁用输出 #

直接调整tsconfig.node.json的编译选项，让它只做类型检查不生成文件：

{
  "compilerOptions": {
    "composite": true,
    "module": "ESNext",
    "moduleResolution": "Node",
    "allowSyntheticDefaultImports": true,
    "noEmit": true // 新增：不生成d.ts等输出文件
  },
  "include": ["vite.config.ts", "src/utils/example.ts"]
}

主项目的tsconfig.json依然负责生成d.ts，两者不再冲突。

方案三：调整VS Code工作区配置 #

在.vscode/settings.json中指定不同文件对应的tsconfig，明确划分职责：

{
  "typescript.tsdk": "node_modules/typescript/lib",
  "typescript.tsconfigPaths": {
    "vite.config.ts": "./tsconfig.node.json",
    "src/**/*.ts": "./tsconfig.json"
  },
  "volar.vitePlugin": true // 确保Volar正确关联Vite配置
}

保存后重启VS Code，让配置生效。

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