根本原因是VSCode不读webpack.config.js或vite.config.ts的resolve.alias，只认tsconfig.json（或jsconfig.json）的baseUrl和paths；必须配置baseUrl为"."、paths键带"*"、值为数组且文件在include范围内，并重启TS Server。
别名路径自动导入不生效，根本原因只有一个
VSCode 不读 webpack.config.js 或 vite.config.ts 里的 resolve.alias，它只信任 tsconfig.json（或 jsconfig.json）中 compilerOptions.baseUrl 和 paths 的声明。哪怕你 Vite 配了 alias: { '@': './src' }，VSCode 也完全无视——没配对 tsconfig.json，@/components/Button 就永远只是个字符串，不会触发自动导入。
必须配对的 tsconfig.json 三要素
以下配置缺一不可，且顺序和写法敏感：
-
baseUrl必须设为"."（项目根目录），不能是"./src"或空字符串；否则paths中的相对路径会解析错位 -
paths每项值必须是数组，哪怕只映射一个目标，例如"@/*": ["src/*"]✅，而"@/*": "src/*"❌（插件静默忽略） - 确保当前文件在
include范围内（默认["**/*.ts", "**/*.tsx"]），Vue 项目需额外加"**/*.vue"并配合Volar
最小可用示例：
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@/*": ["src/*"],
"#utils/*": ["src/utils/*"]
}
},
"include": ["src/**/*", "src/**/*.vue"]
}自动导入触发失败的四个高频卡点
即使 tsconfig.json 正确，下面任一条件不满足，Ctrl + . 都不会弹出带别名的 import 建议：
- 右下角语言模式不是
TypeScript、TypeScript React或Vue（Vue 文件必须用Volar，禁用Vue - Official旧版） -
typescript.suggest.autoImports设置为false（打开设置搜该字段，确认为true） - TS Server 没重启：改完
tsconfig.json后，必须执行命令面板中的Restart TS Server，仅重开窗口无效 - 当前文件未被 TS 语言服务索引：检查 Developer Tools Console 是否报
Cannot find global type 'Promise'或Failed to load typescript，有则重装typescript包
要不要装 Auto Import 插件？看场景
原生 TS 自动导入已覆盖大部分情况，但以下两类建议装 Auto Import - TypeScript（steoates 版）：
- 深度嵌套目录结构（如
src/features/user/profile/hooks/useUserQuery.ts），原生建议常漏掉长路径 - 大量使用
paths别名且需跨多级匹配（如输入formatDate，同时匹配#utils/date和@/shared/utils） - 注意：插件依赖同一份
tsconfig.json，不重复配baseUrl/paths，只开启auto-import.showImportInSuggestions
别名路径自动导入真正的难点不在“怎么开”，而在“为什么开了还不动”——它是个脆弱的链式依赖：tsconfig → TS Server → 语言模式 → 编辑器设置 → 插件协同。任意一环松动，补全就断在半路。
