VSCode不自动导入路径别名是因为语言服务未识别项目结构，需正确配置tsconfig.json的baseUrl/paths、开启autoImports设置、确保文件在include范围内、检查语言模式及TS服务状态。
VSCode 默认不自动导入组件路径，不是功能缺失，而是语言服务没识别到项目结构或配置没生效。关键在 tsconfig.json 或 jsconfig.json、路径别名声明、以及两个核心设置是否开启。
为什么 import 路径别名（如 @/components）不被自动识别
VSCode 不读 Webpack/Vite 的 resolve.alias，只认 tsconfig.json 里的 compilerOptions.baseUrl 和 paths。哪怕你用 Vite 写了 alias: { '@': './src' }，VSCode 也完全无视。
- 必须在
tsconfig.json中显式配置，例如：{ "compilerOptions": { "baseUrl": "./", "paths": { "@/*": ["src/*"], "@components/*": ["src/components/*"] } } } - 改完后必须重启 TS Server：命令面板（
Ctrl+Shift+P）→ 输入Restart TS server→ 回车 - 确保当前文件在
include列表里，比如"include": ["src/**/*"]漏掉tests/或pages/目录，对应路径就无法解析
javascript.suggest.autoImports 和 typescript.suggest.autoImports 必须为 true
这是控制「补全时是否插入 import」的开关，VSCode 默认是 false。光装插件、光有配置文件都不行，这两个布尔值必须显式设为 true。
- 打开设置（
Ctrl+,），搜autoImports，把 JavaScript 和 TypeScript 下的两项都勾上 - 或者直接编辑
settings.json："javascript.suggest.autoImports": true, "typescript.suggest.autoImports": true
- 注意拼写：
autoImports（复数），不是autoImport；大小写敏感，不能写成autoimports - 如果用了多根工作区，只有「活动文件夹」下的配置生效，其他子项目需单独配
tsconfig.json或用"extends"继承
Vue / React 单文件组件中组件名不提示导入
根本原因是语言模式没切对，或插件冲突。比如 .vue 文件默认可能是 HTML 模式，而不是 Vue 模式；.tsx 文件若被识别成 TypeScript 而非 TypeScript React，React Hook 就不会被建议。
- 看右下角状态栏：应显示
Vue（Volar）、TypeScript React（不是纯TypeScript）、JavaScript React等正确语言模式 - 禁用可能劫持补全的插件，比如旧版
Auto Import (wix)、ES7+ React/Redux/React-Native snippets，它们会覆盖Ctrl+Space行为 - 在
.vue的<script></script>区域内输入组件名才有效；<template></template>里直接输是没用的——那是模板编译阶段的事，不是语言服务管的 - 遇到不提示，先保存文件，再按
Ctrl+.（快速修复），这是最稳定触发自动导入的方式，比等补全列表更可靠
第三方库（如 lodash、date-fns）导入失败但 VSCode 还是建议
VSCode 只检查模块存在和类型定义，不验证导出方式。比如 lodash 默认是 default 导出，import { debounce } from 'lodash' 实际会报运行时错误，但 VSCode 仍会建议并插入这行。
- 这不是配置问题，是库本身导出策略导致的。解决办法是手动改成
import debounce from 'lodash/debounce'或启用lodash-es - 类似情况还有
date-fns：必须用import format from 'date-fns/format'，而非import { format } from 'date-fns' - 可配合
typescript.preferences.importModuleSpecifierEnding设为"auto"，避免补全时多加/index - 这类问题不会报错在编辑器里，要等运行或构建时才发现——所以别完全信任自动插入的 import，尤其对非标准导出的库
最常被忽略的一点：VSCode 是否真正加载了 TS/JS 语言服务。右下角显示 JavaScript (Deprecated) 或 Plain Text，说明整个链路从源头就断了，后面所有配置都白搭。先盯住状态栏，再查配置。
