vscode自动导入失效本质是lsp与项目上下文未对齐：语言服务器未启动、配置文件缺失或错误、关键设置拼写/类型错误、路径别名未被tsconfig识别、第三方插件冲突，任一环节断开均导致import不触发。
VSCode自动导入失效，不是插件没装或设置点错了就能概括的事——它本质是语言服务器（LSP）和项目上下文没对齐。只要任一环节断开，import 就不会跳出来。
语言服务器根本没启动或加载失败
状态栏右下角不显示 TS、JS、Python 或 Java，或者显示 Plain Text / JavaScript (Deprecated)，说明语言服务压根没进来。
- 按
Ctrl+Shift+P（Mac 为Cmd+Shift+P）运行Developer: Toggle Developer Tools，切到Console标签页，搜Cannot find module 'typescript'或Failed to load typescript—— 这类报错直接指向 TS 服务未加载 - TS/JS 项目必须有
tsconfig.json或jsconfig.json在工作区根目录；纯 JS 项目若启用checkJs，jsconfig.json里还得带"checkJs": true - 多根工作区中，只有「活动文件夹」下的配置文件被识别；子目录要单独配
tsconfig.json或用extends继承 - 重启不是 reload 窗口，而是关闭所有窗口后重新打开 VSCode，再执行
TypeScript: Restart TS Server或对应语言的重启命令
关键配置项拼写错误或值类型不对
VSCode 对配置项名和值非常敏感，一个字母错、一个引号多，就等于没开。
-
typescript.suggest.autoImports和javascript.suggest.autoImports必须设为true（布尔值），不是字符串"true" - Java 项目是
java.suggest.autoImports（注意末尾s），写成autoImport无效 - Python 需要
python.analysis.autoImportCompletions+python.analysis.indexing同时为true - Go 依赖
gopls模块模式，go.gopls.experimental.workspaceModule必须为true（Go 1.21+ 强制）
路径别名（@/、~/）提示正常但自动导入仍用相对路径
输入 useEffe 补全后插入的是 ../../hooks/useEffect，而不是你想要的 import { useEffect } from '@/hooks'——这是常见但容易被忽略的错位。
- VSCode 的自动导入只认
tsconfig.json/jsconfig.json中的compilerOptions.baseUrl和paths，完全无视 Webpack/Vite 的resolve.alias -
baseUrl必须是相对于tsconfig.json的路径，比如"baseUrl": "./src"，不能写成"./"再配"@/*": ["src/*"] - 修改
tsconfig.json后，必须手动执行TypeScript: Restart TS Server，仅保存文件或重开编辑器无效 -
include字段必须覆盖当前文件路径，比如"include": ["src/**/*", "tests/**/*"]，漏掉tests/目录，里面文件就无法触发别名导入
第三方插件劫持了原生补全逻辑
很多“增强补全”插件（如 Auto Import by wix、ES7+ React/Redux/React-Native snippets）会拦截 Ctrl+Space 或 Tab 行为，导致原生 TS/JS 自动导入建议完全不出现。
- 临时禁用所有非官方插件，只留
redhat.java（Java）、Volar（Vue）、Pylance（Python）等语言官方扩展 - 确认
vetur.validation.script设为false，否则 Vetur 会接管 Vue 文件的脚本分析，干扰 TS 导入建议 - 按
Ctrl+.（Windows/Linux）或Cmd+.（Mac）手动触发 Quick Fix 是最可靠的验证方式：如果弹出 “Add import from …” 选项，说明语言服务就绪；如果只有格式化或重构选项，说明模块路径未被识别
真正卡住人的地方，往往不是某一项配置没开，而是多个条件叠加失效：比如 tsconfig.json 里 moduleResolution 是 classic（应为 node 或 nodenext），同时 baseUrl 路径写错，又装了冲突插件——这时候单看任一环节都像“应该没问题”，但合起来就是不工作。
