vscode自动导入需语言服务加载、项目配置就位、设置项为布尔值true三者缺一不可；常见问题包括状态栏显示plain text、缺失tsconfig.json/jsconfig.json、autoimports设为字符串"true"、冲突插件劫持补全。
VSCode 的自动导入不是“装完插件点一下就全好”的功能，它依赖语言服务正确加载、项目配置就位、设置项布尔值生效——三者缺一不可。多数人卡在 Ctrl+. 没反应，本质是语言服务压根没启动，而不是快捷键按错了。
为什么 Ctrl+. 按了没弹 import 提示？
这是最常被误判为“插件没装好”的问题，实际根源往往在编辑器上下文未建立：
- 右下角状态栏显示
Plain Text、JavaScript (Deprecated)或没语言图标 → 说明当前文件没被识别为 JS/TS/Python 上下文，所有自动导入逻辑都不会触发 - 项目根目录缺失
tsconfig.json（TS）或jsconfig.json（JS）→ 路径解析、模块索引失效，即使写了import { foo } from '@/utils'，VSCode 也找不到@/utils -
javascript.suggest.autoImports或typescript.suggest.autoImports在 settings.json 里被设成"true"（字符串）而非true（布尔值）→ 设置不生效，UI 勾选有时会写错类型 - 安装了旧版
Auto Import (wix)或ES7+ React/Redux snippets→ 它们劫持补全逻辑，覆盖原生 TS/JS 导入建议，导致 Ctrl+Space 只出代码片段，不出 import 项
Python 自动导入必须用 Pylance，且配置不能只靠 UI
默认的 Jedi 语言服务器不支持自动导入补全，Pylance 是硬性前提：
- 打开设置（
Ctrl+,），搜python.languageServer，值必须是"Pylance"（带英文双引号的字符串） - 右下角点击语言模式，确认显示的是
Python (Pylance)，不是Python (Jedi)或Python（无括号后缀） - 必须显式开启
python.analysis.autoImportCompletions：仅 UI 勾选 “Auto Import Completions” 不够，要确保 settings.json 里有"python.analysis.autoImportCompletions": true -
editor.quickSuggestions.other必须为true，否则输datetime.根本不触发补全列表 - 本地模块（如
utils.py）必须在已打开的工作区根目录下，Pylance 不索引未打开的子文件夹
TS/JS 自动导入靠 Ctrl+.，但前提是路径和类型定义都对
Ctrl+.（Windows/Linux）或 Cmd+.（Mac）是唯一稳定触发方式，但它不解决底层路径错误：
- 光标必须停在未定义标识符上（比如刚打完
useEffect，但还没 import），再按Ctrl+.→ 弹出 Quick Fix 菜单，选 “Import ‘useEffect’ from ‘react’” - 路径别名（如
@/hooks）必须在tsconfig.json的compilerOptions.baseUrl和paths里声明，VSCode 不读 Webpack/Vite 的resolve.alias - 第三方库缺少类型定义（如没装
@types/react-router-dom）→useNavigate就不会出现在补全列表里 - 模块导出不匹配：写了
import { foo } from './utils'，但utils.ts只有export default function foo()→ 补全能出现，但运行时报foo is not exported
保存时自动整理 import 的配置别和补全混淆
"editor.codeActionsOnSave": {"source.organizeImports": true} 只在保存时删未用项、合并重复 import、排序，它不负责“新增导入”。新增靠的是语言服务 + Ctrl+. 或补全选择。
- 这个配置对 Python 无效，只作用于 TS/JS
- 如果开启后 import 被删掉，说明对应符号确实没被使用（包括没被调用、没被传参、没被 typeof 判断）
- 想让未使用的 import 保留（比如为后续开发预留），就别开这项，或改用插件如
Auto Import（steoates 版）提供更细粒度控制
真正容易被忽略的是：语言服务启动需要时间，右下角显示“分析中…”时任何补全都不可靠；等它消失后再试。还有，Vue 单文件中 <template></template> 里的组件名提示，依赖 Volar 插件 + 文件语言模式为 vue，不是 html 或 javascript —— 这类上下文切换，比改设置更容易被跳过。
