Vitest测试文件别名导入报错：无法找到模块或类型声明的解决

项目配置背景 #

• vite.config.ts里配置了路径别名：@映射到./src，@mocks映射到./mock
• vitest.config.ts合并了Vite的配置，同时启用了tsconfigPaths插件
• tsconfig.app.json的compilerOptions中配置了对应paths，但include字段仅包含src/**/*，未覆盖tests目录
• 项目结构：根目录下包含mock/、src/、tests/converter.test.ts

问题表现 #

• src目录内使用别名导入代码完全正常
• 在tests/converter.test.ts中使用@/或@mocks别名时，VSCode会抛出错误提示：Cannot find module ~~~ or its corresponding type declarations，且测试、服务运行都无法正常工作
• 同一项目在IntelliJ中无此问题：测试和服务运行正常，也支持Ctrl+左键跳转至别名指向的文件

解决方案 #

修改tsconfig.app.json的include字段，将tests目录加入其中：

{
  "include": ["src/**/*", "tests/**/*"]
}

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