根本原因是TypeScript未正确配置模块解析，需同步tsconfig.json的baseUrl、paths和types，并手动创建vite-env.d.ts声明*.vue模块类型，最后重启TS Server。
为什么 import 一个组件或工具时提示“找不到模块”
根本原因不是路径写错了，而是 TypeScript 没法从当前项目结构里推导出模块存在——它不认 vite.config.ts 里的别名、没加载 src 下的类型声明、或者压根没把 .vue 文件当作可导入模块。
常见错误现象：Cannot find module '@/components/Hello.vue' or its corresponding type declarations，哪怕文件真实存在、路径点击能跳转、运行也不报错。
-
vite.config.ts里配了resolve.alias，但tsconfig.json没同步配置baseUrl和paths - 用了
defineComponent或组合式 API，但没装或没启用@vue/runtime-dom类型支持 -
.vue文件缺少export default，或导出的是setup()函数而非组件对象，TS 类型无法收敛 - 项目根目录下没有
tsconfig.json，或它被放在子目录里（比如src/tsconfig.json），TS 服务直接忽略
必须同步改 tsconfig.json 的三个关键项
Vite 管运行时，TS 管类型检查；两者 alias 不互通。VSCode 底层用的是 TS Server，只看 tsconfig.json。
在项目根目录的 tsconfig.json 中确保包含：
立即学习“前端免费学习笔记（深入）”；
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@/*": ["src/*"],
"@components/*": ["src/components/*"],
"@utils/*": ["src/utils/*"]
},
"types": ["vite/client", "vue"]
},
"include": ["src/**/*", "vite-env.d.ts"]
}
-
baseUrl是paths解析的起点，设为"."才能让@/*映射到src/* -
types必须显式加"vue"，否则 TS 不会自动加载vue的全局类型（比如defineProps） -
include要覆盖vite-env.d.ts，否则import.meta.env会报错
vite-env.d.ts 缺失或内容不对会导致 Vue 特有语法报错
这个文件不是 Vite 自动生成的，得手动建。VSCode 提示 defineProps 未声明、ref 类型不明确，大概率是它没生效。
在项目根目录或 src 下新建 vite-env.d.ts，内容必须包含：
/// <reference types="vite/client" />
declare module '*.vue' {
import type { DefineComponent } from 'vue'
const component: DefineComponent<{}, {}, any>
export default component
}
- 第一行不能少，否则
import.meta.env类型不识别 -
declare module '*.vue'告诉 TS 所有.vue文件默认导出一个组件类型，不然import Comp from './X.vue'会标红 - 如果用了
defineAsyncComponent或defineEmits，还得补上对应声明，但基础场景上面两行够用
重启 TS Server 比重开 VSCode 更快生效
改完配置后，VSCode 往往还缓着旧的类型信息，直接关窗口再开效率低，而且容易漏掉其他打开的文件夹。
- 快捷键
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入Typescript: Restart TS server并执行 - 观察右下角状态栏是否出现
Starting TS Server...→TS Server ready - 如果仍有报错，用
Ctrl+Shift+P运行Developer: Toggle Developer Tools，看 Console 里有没有TS Server error，常见是tsconfig.json路径解析失败或 JSON 格式错误
最常被忽略的一点：VSCode 工作区开了多个文件夹时，TS Server 默认只读最外层的 tsconfig.json。如果你的 Vue 项目是子目录（比如 monorepo/packages/web），就得在该子目录下放一份完整的 tsconfig.json 和 vite-env.d.ts，且确保 VSCode 当前工作区定位准确。
