Vue2.7迁移后TS6307错误：编译器给.vue文件加.ts扩展名

错误原因 #

这个报错是Vue2.7集成官方TS支持后，原有类型声明和TS模块解析逻辑冲突导致的，而且只有当项目存在其他真实编译错误时才会触发——因为TS在遇到错误时会 fallback 到基础解析规则，尝试去找带.ts后缀的同名文件，但你的tsconfig里没包含这类文件，所以弹出TS6307错误。

负责文件扩展名解析的关键配置 #

1. TypeScript 核心配置：compilerOptions.resolveExtensions #

TS会按照这个数组里的扩展名顺序查找文件，默认没包含.vue，所以需要显式添加，确保TS能识别.vue文件为合法模块。在tsconfig.json的compilerOptions里补充：

"resolveExtensions": [".vue", ".ts", ".tsx", ".js", ".jsx", ".json"]

2. Vue 编译器配置：vueCompilerOptions #

你已经设置了vueCompilerOptions.target: 2.7，这是开启Vue2.7官方TS支持的关键，它会让TS编译器正确处理.vue文件的内部逻辑，包括扩展名映射。如果用Volar作为TS工具，这个配置是它解析.vue文件的核心依据。

3. 构建工具（如Webpack）的扩展名配置 #

如果项目用Webpack打包，resolve.extensions也得包含.vue，不然构建时会找不到.vue文件。在webpack配置里加：

resolve: {
  extensions: ['.vue', '.ts', '.js', '.json']
}

额外修复步骤 #

• 更新shims-vue.d.ts适配Vue2.7：原有的简单声明可能和官方类型冲突，替换成更准确的版本：

declare module '*.vue' {
  import type { DefineComponent } from 'vue'
  const component: DefineComponent<{}, {}, any>
  export default component
}

• 清理TS缓存：因为你开了composite: true，根目录会生成.tsbuildinfo文件，删掉它再重启编辑器/TS服务，避免缓存导致的解析异常。
• 确认tsconfig的include数组：你已经包含了src/**/*.vue，这部分没问题，不用改。

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