VSCode自动导入需语言服务激活且文件正确识别，右下角必须显示TypeScript/JavaScript/Python（带齿轮图标），禁用Plain Text；项目根目录需tsconfig.json或jsconfig.json；autoImports等配置须为true布尔值；Ctrl+.触发Quick Fix前需光标停在未定义符号上。
VSCode 的自动导入不是装个插件就“自动生效”的功能，它依赖语言服务（TypeScript Server、Pylance 等）在正确配置下触发语义分析。如果 useState 输完回车只留名字、Ctrl+. 没反应、右下角显示 Plain Text，那说明底层服务根本没加载——补全逻辑压根没启动。
确认语言服务已激活且文件被正确识别
这是所有自动导入功能的前提，90% 的失效问题卡在这一步。
- 看右下角状态栏：必须显示
TypeScript、JavaScript或Python（带齿轮图标），不能是Plain Text、HTML或Vue (Deprecated) - Vue 单文件中 template 里写
vue（不是html），并确认已安装Volar（非 Vue Official） - Python 文件显示
Python (Jedi)？点击切换 → 选Python (Pylance)；再检查设置中python.languageServer值是否为"Pylance" - TS/JS 项目：项目根目录必须存在
tsconfig.json或jsconfig.json，哪怕内容只是{"compilerOptions": {}}
关键配置项必须设为布尔值 true
这些设置控制的是「IntelliSense 下拉列表里是否出现带 import 前缀的建议项」，不是开关式总控，拼写、类型、位置都错不得。
-
typescript.suggest.autoImports和javascript.suggest.autoImports必须是布尔值true，不是字符串"true" - Python 用户还需确保：
python.analysis.autoImportCompletions为true，且editor.quickSuggestions.other为true - 推荐直接编辑
settings.json，避免 UI 设置被插件覆盖或缓存干扰：
{
"typescript.suggest.autoImports": true,
"javascript.suggest.autoImports": true,
"python.analysis.autoImportCompletions": true,
"editor.quickSuggestions": {
"other": true
}
}
改完保存，重启 VSCode 或运行命令 TypeScript: Restart TS server / Python: Restart Language Server。
别等输完回车——用 Ctrl+. 主动触发 Quick Fix
依赖「输入即补全」非常不可靠：网络延迟、索引未完成、补全列表被其他插件劫持，都会导致只插入符号名、不加 import。
- 光标停在未定义的符号上（如刚打完
useEffect但还没 import），按Ctrl+.（Windows/Linux）或Cmd+.（macOS） - 弹出 Quick Fix 菜单后，选
Import 'useEffect' from 'react'这类带明确路径的选项 - 若
Ctrl+.没反应，先检查上面两条是否全部满足；再禁用可能冲突的插件，如旧版Auto Import (wix)、ES7+ React/Redux snippets - Python 场景下，也可输前几个字母（如
datetim）后按Ctrl+Space，从带灯泡图标的选项中选择
路径别名和本地模块导入失败怎么办
VSCode 不读 Webpack/Vite 的 resolve.alias，它只认 tsconfig.json 或 jsconfig.json 中的 baseUrl 和 paths。
- 例如想用
@/hooks/useApi，需在tsconfig.json的compilerOptions中配置：
"baseUrl": ".",
"paths": {
"@/*": ["src/*"]
}
- 改完必须重启 TypeScript Server，否则别名不生效
- 本地模块（如
utils.py）要能被 Pylance 索引，该文件必须位于当前 VSCode 工作区打开的根目录下，不能藏在未打开的子文件夹里 - 第三方库缺少类型定义（如没装
@types/lodash），也会导致符号无法被识别，自然不触发导入建议
最常被忽略的点：语言服务崩溃时，Console 里会报 Cannot find global type 'Promise' 或 Failed to load typescript —— 这时候重装 typescript 包、清掉 node_modules/.cache、再重启服务，比反复调设置更有效。
