SvelteKit使用vitest时vite.config.ts出现“No overload matches this call”错误

问题场景 #

通过pnpx sv create sveltekit-test2创建SvelteKit应用并勾选Vitest选项后，使用如下vite.config.ts配置：

import { defineConfig } from "vitest/config";
import { sveltekit } from '@sveltejs/kit/vite';

export default defineConfig({
    plugins: [sveltekit()],
    test: {
        include: ['src/**/*.{test,spec}.{js,ts}']
    }
});

执行pnpm check或在VS Code中，第5行第12列会出现No overload matches this call类型错误，但将defineConfig改为从vite包导入时，错误消失且能正常运行。

问题原因 #

vitest/config导出的defineConfig仅针对Vitest自身的配置类型设计，没有包含SvelteKit插件所需的完整Vite配置类型定义，导致类型校验时无法识别sveltekit()插件的类型，触发重载匹配失败错误。

解决方案 #

方案一：使用Vite的defineConfig并合并Vitest类型（推荐） #

从vite导入defineConfig，同时引入Vitest的配置类型来增强类型提示，确保配置项的类型校验通过：

import { defineConfig } from "vite";
import type { UserConfig as VitestUserConfig } from "vitest/config";
import { sveltekit } from '@sveltejs/kit/vite';

// 合并Vite基础配置与Vitest测试配置的类型
type ViteConfig = Parameters<typeof defineConfig>[0] & {
  test: VitestUserConfig['test'];
};

export default defineConfig({
  plugins: [sveltekit()],
  test: {
    include: ['src/**/*.{test,spec}.{js,ts}']
  } satisfies VitestUserConfig['test']
} as ViteConfig);

方案二：保留Vitest的defineConfig并强制类型转换 #

如果坚持使用vitest/config的defineConfig，可以将sveltekit()插件强制转换为Vite的PluginOption类型，绕过类型校验：

import { defineConfig } from "vitest/config";
import type { PluginOption } from "vite";
import { sveltekit } from '@sveltejs/kit/vite';

export default defineConfig({
  plugins: [sveltekit() as PluginOption],
  test: {
    include: ['src/**/*.{test,spec}.{js,ts}']
  }
});

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