VSCode自动导入由语言服务驱动，需正确配置tsconfig.json/jsconfig.json、启用对应语言模式、安装Volar（Vue）或Pylance（Python），并确保typescript.suggest.autoImports等设置为true；触发推荐用Ctrl+.而非回车，保存时可配置"source.organizeImports": true自动整理。
VSCode 的自动导入不是“装个插件就自动生效”的功能，它实际由语言服务（TypeScript Server、Pylance 等）驱动，配置错一点，Ctrl+. 就不弹建议，useState 输完回车也只留个名字——根本不会加 import。
为什么输入函数名后没出现 import 建议？
最常见原因是语言服务压根没加载成功，或当前文件没被识别为对应语言上下文。
- 看右下角状态栏：显示
Plain Text、JavaScript (Deprecated)或没有语言图标，说明 VSCode 没启用 JS/TS 语言服务——此时所有自动导入逻辑都不会触发 - 检查项目根目录是否存在
tsconfig.json（TS）或jsconfig.json（JS），哪怕内容是{"compilerOptions": {}}也必须存在；否则路径解析、模块索引全失效 - Vue 单文件中 template 里写
Volar（非 Vue - Official），且文件语言模式是vue（右下角点击切换），不是html或javascript - 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，Console 里若报Failed to load typescript或Cannot find global type 'Promise'，说明 TS 服务崩溃或版本冲突，需重装typescript包
如何稳定触发 import 补全？别只靠输完回车
依赖“输入即补全”容易失败，真正可靠的是主动调用快速修复（Quick Fix）。
- 把光标停在未定义的符号上（比如刚打完
useEffect但还没 import），按Ctrl+.（Windows/Linux）或Cmd+.（macOS）——这是最稳的触发方式，不依赖补全列表是否弹出 - 如果
Ctrl+.没反应，先确认设置里typescript.suggest.autoImports和javascript.suggest.autoImports都是布尔值true，不是字符串"true" - 禁用可能劫持补全行为的插件，比如旧版
Auto Import (wix)、ES7+ React/Redux/React-Native snippets，它们会覆盖 TS 原生逻辑，导致Ctrl+Space后只有代码片段、没有 import 项 - 对 Python 用户：确保使用
Pylance（非 Pthon 扩展自带的语言服务器），并开启python.analysis.autoImportCompletions
路径别名（@/、~/）导入失败？tsconfig.json 改了不生效
VSCode 只认 tsconfig.json 里的 baseUrl 和 paths，Webpack/Vite 的 resolve.alias 对它完全无效。
-
baseUrl必须是相对于tsconfig.json的路径，例如"baseUrl": "./src"，不能写成"./"再配"@/*": ["src/*"]—— 这种写法 TS 编译能过，但 VSCode 路径解析会失败 - 改完
tsconfig.json后，必须手动执行命令面板中的TypeScript: Restart TS server；仅重启 VSCode 或重开文件没用 - 确认当前文件在
tsconfig.json的include列表内，例如"include": ["src/**/*", "types/**/*"]，漏掉tests/目录，里面文件就无法解析@/别名 - 如果用的是 JS 项目（
jsconfig.json），同样要配compilerOptions.baseUrl和paths，且checkJs必须为true
保存时自动整理 import：组织 + 清理一步到位
仅靠补全导入还不够，常会残留无用 import 或顺序混乱。开启保存时自动整理，能强制标准化。
- 在
settings.json中添加："editor.codeActionsOnSave": {"source.organizeImports": true} - 该操作会同时做两件事：插入缺失的 import（基于当前文件中已用但未导入的符号），并删除所有未使用的 import（包括手动加的冗余项）
- 注意：它不会重排 import 分组（如把
react放最前、第三方居中、本地路径放最后），如需此效果，得额外配 ESLint 或 Prettier 规则 - 如果保存后 import 没变化，检查当前文件是否被识别为 TS/JS 模式，以及有没有其他扩展（如 ESLint 插件）禁用了
source.organizeImports的 code action
最容易被忽略的是：多根工作区中，只有「活动文件夹」下的 tsconfig.json 生效；子项目若没自己的配置，或没通过 extends 继承主配置，路径别名和自动导入就会静默失效——这种问题不会报错，只会让你反复怀疑是不是插件坏了。
