VSCode自动导入失效的根本原因是TS Server未加载有效类型声明，常见于缺少tsconfig.json、include未覆盖.d.ts文件、配置文件未被正确加载、声明文件位置错误或未重启TS Server。
VSCode 自动导入模块时提示“找不到声明文件”，不是代码写错了，而是 TypeScript 语言服务压根没看到那个模块的类型——它连“这玩意儿有类型”都不知道，更别说自动补 import 了。
为什么 Ctrl+. 没反应或只显示“Add import from 'xxx'”但点不了
根本原因是 TS Server 没加载到有效的类型声明，常见于以下几种情况：
- 项目根目录下没有
tsconfig.json（哪怕内容为空，也得有） -
tsconfig.json的include字段没覆盖到你的.d.ts声明文件（比如env.d.ts或vite-env.d.ts） - 用了 Vite / Vue CLI 等工具，但 VSCode 加载的是默认
tsconfig.json，而实际路径别名、类型扩展都写在tsconfig.app.json里，且没被extends引入 - 状态栏右下角显示的 TS 版本旁没标出配置文件路径（点开确认是否加载了你改的那个）
declare module "*.vue" 声明放哪才生效
很多教程让你在 src/ 下建 shims-vue.d.ts，但这在 Vite + Vue 3 项目中基本无效——TS Server 不会从 src/ 里自动扫描它，除非你显式加进 include，且文件位置和内容必须匹配当前工具链。
- 正确位置：项目根目录（和
tsconfig.json同级），推荐命名为env.d.ts或vite-env.d.ts - 内容必须包含
/// <reference types="vite/client"></reference>，否则import.meta.env这类也会报错 -
tsconfig.json中的include必须显式列出它，例如："include": ["env.d.ts", "src/**/*"] - 别再留
src/shims-vue.d.ts—— 它不仅不生效，还可能干扰路径解析
第三方包提示“找不到模块”但运行正常
这是典型的类型缺失，而非路径错误。VSCode 能跑通，是因为 Node.js 运行时不校验类型；但 TS Server 想给你自动导入，就必须知道这个包导出了什么。
- 先确认包本身是否带内建类型（如
axios、lodash-es通常自带） - 若无，则安装对应类型包：
npm install -D @types/xxx（注意是-D，且包名必须完全匹配） - 某些包（如
dayjs）类型需手动启用：在env.d.ts中加/// <reference types="dayjs"></reference> - 用
virtual:开头的模块（如virtual:svg-icons-register）必须手动声明空模块：declare module "virtual:svg-icons-register" {}
重启不是可选项，是必做动作
VSCode 的 TS Server 一旦加载配置，就不会自动重读。改完 tsconfig.json、加了 env.d.ts、装了 @types，不重启就等于没改。
- 快捷键：
Ctrl+Shift+P→ 输入TypeScript: Restart TS server→ 回车 - 别信 “重载窗口” 或 “关闭再开”，只有重启 TS Server 才能强制重新解析所有声明和路径
- 如果右下角 TS 版本后没显示配置路径，或显示 “No config file found”，说明重启失败，回去检查
tsconfig.json是否真在根目录、内容是否合法 JSON
最常被忽略的一点：baseUrl 和 paths 必须同时存在且语义一致——baseUrl: "." 是前提，否则 @/* 映射永远不生效；而 paths 里的路径必须是相对 baseUrl 的，不能写成 "@/*": ["src/*"] 却把 baseUrl 设成 "src"。
