VSCode自动导入本质是语言服务驱动的语义行为，需同时满足四条件：右下角显示TS/JS/Python/vue模式、项目根目录存在tsconfig.json/jsconfig.json、settings中对应autoImports设为true（布尔值）、禁用冲突插件；缺一不可。
VSCode 的自动导入不是“装插件就生效”的功能，它本质是语言服务（TypeScript Server、Pylance、Volar）在正确配置下触发的语义行为。如果 useState 输完回车只留名字、Ctrl+. 没反应、右下角显示 Plain Text，那说明语言服务根本没加载——补全逻辑压根没启动。
检查语言模式和语言服务是否就位
这是所有问题的起点。VSCode 必须识别当前文件为对应语言上下文，才能启用自动导入逻辑：
- 看右下角状态栏：必须显示
TypeScript、JavaScript、Python或vue（不是HTML、Plain Text或JavaScript (Deprecated)） - 若显示异常，点击状态栏语言名 → 手动切换为正确模式（如
vue文件选Volar，.py文件选Pylance） - 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切到 Console 标签页，输入require('typescript')—— 若报Cannot find module 'typescript'，说明 TS 服务未加载
确认项目配置文件存在且最小可用
没有 tsconfig.json 或 jsconfig.json，VSCode 就无法解析模块路径、索引第三方库，自动导入会直接失效：
- TypeScript 项目：根目录必须有
tsconfig.json，哪怕内容只是{"compilerOptions": {}} - JavaScript 项目：根目录必须有
jsconfig.json，推荐加"checkJs": true - Vue 单文件：需确保已安装
Volar（非 Vue Official），且vue文件语言模式为vue - Python 项目：无需
pyproject.toml或setup.py，但.py文件必须在 VSCode 工作区根目录或其子目录下，否则 Pylance 不索引
设置必须为布尔值 true，不是字符串
这两个设置控制「补全时是否插入 import」，但只在语言服务激活后才起作用，且值必须是布尔类型：
- 打开
settings.json（Ctrl+,→ 右上角“打开设置(JSON)”） - 加入以下两行（注意：不要加引号包裹
true）："javascript.suggest.autoImports": true"typescript.suggest.autoImports": true - Python 用户还需加：
"python.languageServer": "Pylance""python.analysis.autoImportCompletions": true"editor.quickSuggestions": {"other": true} - 别和
editor.codeActionsOnSave混淆：后者是保存时整理 import，前者才是补全时插入的关键
用 Ctrl+. 触发，别等回车
依赖“输完回车”来触发自动导入非常不可靠；真正稳定的方式是主动调用 Quick Fix：
- 把光标停在未定义的符号上（比如刚打完
useEffect但还没 import） - 按
Ctrl+.（Windows/Linux）或Cmd+.（Mac）——这是最稳的触发方式 - 若
Ctrl+.没反应，先确认上面三项都满足；再禁用可能劫持补全的插件，比如旧版Auto Import (wix)、ES7+ React/Redux snippets - 路径别名（如
@/hooks）导入失败？VSCode 完全不读 Webpack/Vite 的resolve.alias，它只认tsconfig.json里的baseUrl和paths
复杂点在于：语言服务、配置文件、设置项、语言模式这四者必须同时就位，缺一不可。最容易被忽略的是状态栏显示 Plain Text 还在调设置，或者 tsconfig.json 放错位置导致路径解析完全失效。
