TS2307错误主因是VSCode的TypeScript服务未正确加载tsconfig.json或类型声明未覆盖import路径；需检查TS版本、配置继承、env.d.ts位置与内容，并重启TS服务器。
VSCode里报TS2307，基本不是代码写错了，而是TypeScript语言服务没找对路——它压根没看到你import的模块在哪，更别说它的类型了。核心矛盾就一个：VSCode用的TypeScript Server没加载到正确的tsconfig.json，或者类型声明根本没覆盖到你import的路径或后缀。
为什么VSCode报错但tsc能过？
因为VSCode默认只读项目根目录下的tsconfig.json，而Vite、Vue CLI等工具常把真正的配置拆成tsconfig.app.json、tsconfig.node.json等多份。如果你只在tsconfig.app.json里配了"paths"或include，但VSCode没加载它，那所有别名（比如@/components）和*.vue导入都会被标红。
- 检查VSCode右下角TS版本旁是否显示“
tsconfig.json”——点开确认它加载的是哪一份 - 打开命令面板（Ctrl+Shift+P），运行
Typescript: Select TypeScript Version，选Use Workspace Version - 确保根
tsconfig.json里有"extends": "./tsconfig.app.json"，或者直接把compilerOptions.paths和include挪到根配置里
*.vue模块找不到？别乱建shims-vue.d.ts
很多教程让你在src/下新建shims-vue.d.ts，但这只对旧版Vue CLI有效。Vite + Vue 3项目中，这个文件必须放在**项目根目录**（和tsconfig.json同级），且文件名得是env.d.ts或global.d.ts，并确保tsconfig.json的include字段包含它：
"include": ["env.d.ts", "src/**/*"]
内容也得更新为：
/// <reference types="vite/client" />
declare module "*.vue" {
import type { DefineComponent } from "vue";
const component: DefineComponent<{}, {}, any>;
export default component;
}
- 用
/// <reference types="vite/client" />才能让Vite的类型（如import.meta.env）也被识别 - 如果用了Volar插件，优先关掉内置TS插件（Settings → “TypeScript > Suggest: Auto Imports” → 关），否则两者冲突会更乱
- 删掉
src/shims-vue.d.ts——它会被TS忽略，还可能干扰路径解析
virtual:开头的模块（比如virtual:svg-icons-register）怎么声明？
这类模块根本不存在物理文件，是Vite插件运行时生成的。TypeScript不可能靠文件系统找到它，必须手动告诉它：“这玩意儿有类型，信我”。做法很简单：在env.d.ts里加一条空模块声明：
declare module "virtual:svg-icons-register" {}
- 不需要导出任何东西，空声明就够了——只要TS知道这模块“存在”，就不会报TS2307
- 如果插件文档明确提供了类型（比如
vite-plugin-svg-icons的registerIcons函数），可以补全：
declare module "virtual:svg-icons-register" {
const registerIcons: (icons: Record<string, string>) => void;
export default registerIcons;
}
- 别试图在
node_modules里搜这个模块——它不在那儿，搜不到是正常的
最常被忽略的一点：改完tsconfig.json或.d.ts后，VSCode不会自动重载TS服务。必须手动触发——关闭所有TS服务器（Ctrl+Shift+P → Typescript: Restart TS server），再等几秒看右下角状态栏是否恢复正常。不重启，所有配置都是白搭。
