vscode自动导入需语言服务、项目配置和设置三者对齐；常见失效原因包括语言模式错误、缺失jsconfig.json/tsconfig.json、vue项目未用volar、ts服务崩溃、codeactionsonsave配置不当或被工作区覆盖、eslint未启用jsx校验、自动保存失效等。

VSCode 的自动导入不会“装完插件就生效”，它依赖语言服务、项目配置和设置三者严格对齐；配错任意一环，Ctrl+. 就不弹建议，输完 useState 回车也只留个名字。

为什么 Ctrl+. 不提示自动导入

最常见原因是语言服务没加载或文件未被识别为对应语言上下文：

• 看右下角状态栏：显示 Plain Text、JavaScript (Deprecated) 或无语言图标 → 说明语言模式错误，需点击切换为 javascript、typescript 或 vue
• 项目根目录缺失 tsconfig.json（TS）或 jsconfig.json（JS），哪怕内容是 {"compilerOptions": {}} 也必须存在，否则模块路径无法解析
• Vue 单文件中 <template></template> 里写 <mycomp></mycomp> 不提示？确认已安装 Volar（不是 Vue - Official），且文件语言模式是 vue
• 打开命令面板 Ctrl+Shift+P，运行 Developer: Toggle Developer Tools，Console 中若报 Failed to load typescript 或 Cannot find global type 'Promise'，说明 TS 服务崩溃，需重装 typescript 包

editor.codeActionsOnSave 怎么配才真正生效

这个设置控制保存时是否自动增删 import，但只写 {"source.organizeImports": true} 不够，还需确保后端支持：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 必须配合语言专属配置，例如 TypeScript 项目要启用 "typescript.preferences.autoImportSuggestionsEnabled": true
• Python 项目需 Pylance + python.defaultInterpreterPath 指向正确环境，且 editor.codeActionsOnSave 中应写 "source.organizeImports"（不是 source.fixAll）
• 如果保存后没反应，检查是否被工作区设置覆盖：右下角显示「工作区」时，打开 .vscode/settings.json 确认没写 "files.autoSave": "off" 或禁用相关 action
• 某些 ESLint 规则（如 eslint-plugin-react）需额外在 eslint.validate 中加入 javascriptreact 和 typescriptreact 才能触发 JSX 组件自动导入

自动保存与自动导入的协同陷阱

自动导入依赖“保存”动作触发，但若自动保存本身失效，整个链路就断了：

• files.autoSave 必须设为字符串值："afterDelay"、"onFocusChange" 等；设成 true 或 1 会被直接忽略
• 若同时启用了 editor.formatOnSave，而格式化插件（如 Prettier）安装失败或配置缺失，VS Code 会静默取消本次保存 → 自动导入也就不会运行
• files.autoSaveExclude 排除构建目录（如 "**/dist/**"）很重要：否则保存时可能反复触发构建，导致语言服务卡顿甚至中断，间接让自动导入失灵
• 延迟保存（afterDelay）设太短（如 100 毫秒）在 WSL 或机械硬盘上易感知卡顿，设太长（如 3000）又容易切走前忘记改了什么——推荐 800–1500 毫秒

真正容易被忽略的是：自动保存只对“已修改”的文件起作用，而自动导入只在保存瞬间由语言服务驱动执行；两者之间没有缓存、不跨会话、不保底重试——任一环节掉链子，就白配。