VSCode自动导入需语言服务激活、项目含tsconfig.json/jsconfig.json、settings中javascript.suggest.autoImports和typescript.suggest.autoImports设为true、禁用冲突插件、路径别名须在tsconfig.json配置baseUrl/paths并重启TS Server。
VSCode 能自动识别并导入模块，但前提是语言服务已加载、项目配置正确、设置没被覆盖——不是装了插件就自动生效，而是整套链路必须对齐。
确认语言服务是否真正运行
自动导入完全依赖 TypeScript Server、Pylance 或其他语言服务器。如果右下角状态栏显示 Plain Text、HTML 或带感叹号的 JavaScript，说明服务根本没启动。
- 打开命令面板（
Ctrl+Shift+P），运行TypeScript: Open TS Server Log或Python: Open Language Server Log，看是否有报错（比如Cannot find module 'typescript'） - 项目根目录必须有
tsconfig.json（TS）或jsconfig.json（JS），哪怕内容只是{"compilerOptions": {}} - Vue 单文件需确保语言模式是
vue（点右下角切换），且已安装 Volar；旧版 Vetur 会拦截补全
检查关键设置是否启用
javascript.suggest.autoImports 和 typescript.suggest.autoImports 必须为布尔值 true，不是字符串 "true"，也不是靠插件“默认开启”。
- 在
settings.json中显式添加这两行（别漏掉逗号）："javascript.suggest.autoImports": true,<br>"typescript.suggest.autoImports": true
- Python 用户要确认启用了
python.analysis.autoImportCompletions，且语言服务器设为Pylance - 禁用可能冲突的插件，比如旧版
Auto Import (wix)或ES7+ React/Redux snippets，它们会劫持Ctrl+Space补全列表
触发自动导入的两种可靠方式
没有全局“一键导入快捷键”，但有两个稳定入口：
- 光标停在未定义的标识符上（比如红色波浪线的
useState），按Ctrl+.（Windows/Linux）或Cmd+.（Mac），从弹出菜单选 “Import ‘useState’ from ‘react’” - 直接输入函数名（如
debounce），在 IntelliSense 下拉列表中选带import前缀的项，回车即插入完整 import 行 - 注意：这些操作只在编辑器文本焦点内生效（
when: "editorTextFocus && !editorReadonly"），终端、设置页里按无效
路径别名和第三方库导入失败怎么办
VSCode 不读 vite.config.ts 或 webpack.config.js 里的 resolve.alias，它只认 tsconfig.json 的 baseUrl 和 paths。
- 例如想用
@/utils代替../../utils，必须在tsconfig.json中配置："compilerOptions": {<br> "baseUrl": ".",<br> "paths": {<br> "@/*": ["src/*"]<br> }<br>} - 第三方库无提示？先确认是否安装了对应类型定义，比如
npm install -D @types/lodash - 保存时自动整理 import（增删+排序）可配
"editor.codeActionsOnSave": {"source.organizeImports": true}，但它不会帮你决定该用import debounce from 'lodash/debounce'还是import { debounce } from 'lodash'
最常被忽略的一点：所有配置都生效的前提是文件类型被正确识别。一个 .ts 文件如果被当成 Plain Text，再全的设置也白搭——务必盯住右下角状态栏，那是整个自动导入链路的起点。
