VSCode自动导入不识别@/别名的根本原因是TS/JS语言服务仅解析tsconfig.json或jsconfig.json中的paths，无视vite/webpack的alias配置；需确保baseUrl为"."、paths含"*"通配符、配置文件位于工作区根目录，并启用autoImports及organizeImports设置，最后重启TS Server验证。
为什么自动导入不识别 @/ 别名
VSCode 的自动导入（source.organizeImports 和补全建议）不识别 @/，根本原因不是插件没装或代码写错了，而是 TypeScript/JavaScript 语言服务压根没把 @/ 当作合法路径前缀来解析。它只读 tsconfig.json 或 jsconfig.json 里的 compilerOptions.paths，完全无视 vite.config.ts 或 webpack.config.js 中的 resolve.alias。所以即使项目跑得通、打包没问题，编辑器照样标红、不提示、不跳转。
检查 tsconfig.json 或 jsconfig.json 是否生效
这是最常被跳过的一步。配置文件必须满足三个硬性条件，缺一不可：
-
baseUrl必须设为"."（不能是"./"、""或"src"） -
paths的 key 必须带通配符*（如"@/*"），value 也必须是数组且含通配符（如["src/*"]） - 配置文件必须位于 VSCode 工作区根目录（即你通过「File → Open Folder」打开的那个文件夹），而不是子目录里
纯 JavaScript 项目必须用 jsconfig.json；TypeScript 项目优先用 tsconfig.json。如果两个都存在，tsconfig.json 会覆盖 jsconfig.json —— 即便你写的是 .js 文件。
确认 autoImports 和 codeActionsOnSave 已启用
即使路径映射正确，自动导入功能本身也可能被关掉。打开 VSCode 设置（Ctrl+,），搜索并确认以下两项为 true：
typescript.suggest.autoImportsjavascript.suggest.autoImports-
editor.codeActionsOnSave中的"source.organizeImports"
更稳妥的做法是直接在 settings.json 里加这几行：
{
"typescript.suggest.autoImports": true,
"javascript.suggest.autoImports": true,
"editor.codeActionsOnSave": {
"source.organizeImports": true
}
}
注意：这些设置对当前工作区或用户全局生效，但不会覆盖项目级配置（比如 .vscode/settings.json 中的同名项）。
重启 TS Server 并验证是否加载了正确配置
改完配置后，VSCode 不会自动重载语言服务。必须手动触发：
- 按
Ctrl+Shift+P（Mac 是Cmd+Shift+P）→ 输入TypeScript: Restart TS Server→ 回车 - 观察右下角状态栏：应显示类似
TypeScript 5.6.3；若显示JavaScript，说明当前文件未被 TS 服务接管（常见于.js文件未开启allowJs，或不在include范围内） - 按
Ctrl+Shift+P→TypeScript: Open TS Server Log，搜索config或baseUrl，确认日志里加载的是你刚改的那个tsconfig.json路径
别名路径补全和自动导入依赖完整的符号索引链。如果某个 src/utils/index.ts 文件没被 include 进配置，哪怕它物理存在，语言服务也看不到它的导出，自然无法提供自动导入建议。
