VSCode TypeScript/JavaScript 自动导入默认不生效，因其依赖语言服务器和正确配置：需存在有效的 tsconfig.json/jsconfig.json、开启对应设置项、禁用冲突插件，并确保语言服务正常加载。
VSCode 的 TypeScript/JavaScript 自动导入为什么默认不生效
因为 VSCode 本身不内置自动导入逻辑，它完全依赖语言服务器（TypeScript Server 或 JS 语言特性）和编辑器配置协同工作。没开对开关、装错插件、或项目没正确识别 tsconfig.json / jsconfig.json，都会导致补全时死活不加 import。
常见错误现象：
– 输入函数名后回车，只插入名字，不带 import
– Ctrl+Space 补全列表里有模块项，但选中后仍不导入
– 新建文件里写 useState，补全后没反应
- 必须确保项目根目录下存在有效的
tsconfig.json（TS 项目）或jsconfig.json（JS 项目），且其中"compilerOptions.moduleResolution"是"node"或"nodenext" - VSCode 设置里要打开
"typescript.preferences.autoImportSuggestions.enabled"（TS）和"javascript.suggest.autoImports"（JS），两者需分别开启 - 禁用第三方 JavaScript/TypeScript 插件（比如某些“增强补全”插件），它们常劫持原生导入逻辑导致失效
如何验证当前文件是否支持自动导入
最直接的办法是看状态栏右下角：如果显示 TS 或 JS，且旁边有齿轮图标或语言模式标识，说明语言服务已加载；如果显示 Plain Text 或无响应，那根本没进 TS/JS 模式，自动导入必然无效。
- 按
Ctrl+Shift+P打开命令面板，运行Developer: Toggle Developer Tools，切换到 Console 标签页，输入require('typescript')看是否报错——报错说明 TS 语言服务没加载成功 - 在代码中故意写个不存在的类型（如
const x: NonExistentType = 1;），如果没红色波浪线，说明类型检查关闭，自动导入大概率也关了 - 打开一个已有
import的文件，删掉某条import，再在使用处触发补全（比如输入useEffe→Tab），看是否弹出带“import from”提示的选项
React + TypeScript 项目里 import 路径总是不对怎么办
VSCode 默认用相对路径生成 import，但很多项目用 baseUrl + paths 配置了别名（如 @/hooks），这时候自动导入仍会输出 ../../hooks/useX，而不是你想要的 import { useX } from '@/hooks'。
- 在
tsconfig.json的compilerOptions中确认已设置"baseUrl": "./"和"paths"映射 - 必须重启 TS 语言服务：按
Ctrl+Shift+P→ 运行TypeScript: Restart TS server，否则新配置不生效 - VSCode 设置中启用
"typescript.preferences.importModuleSpecifierEnding"为"index"或"auto"，避免补全时多加/index - 如果仍走相对路径，检查有没有装
Auto Import这类第三方插件——它默认不读tsconfig.json.paths，建议卸载，用原生能力
为什么保存时没自动整理 import（排序/删除未用项）
自动导入 ≠ 自动整理。VSCode 原生不带保存时优化 import 的功能，这是 ESLint 或 Prettier 的活。但可以低成本接入。
- 安装官方插件
ESLint，并在项目中配置eslint-plugin-import，启用import/order和import/no-unused-modules规则 - 在
.vscode/settings.json中添加："editor.codeActionsOnSave": { "source.organizeImports": true }——这个是 VSCode 原生的，只做基础增删和排序，不处理别名或样式（如单引号/双引号） - 注意：该设置仅对 TS/JS 文件生效，且要求文件被识别为 TS/JS（即有正确
lang="ts"或lang="jsx"标识）；Vue 单文件里的<script>块需额外配置"typescript.preferences.includePackageJsonAutoImports"并确保vetur或volar正常工作
最容易被忽略的是：source.organizeImports 不会重写已有 import 的路径格式（比如把相对路径转成别名），它只管顺序和冗余。真要统一路径风格，得靠 ESLint + import/namespace 类规则，或者手动跑 npx eslint --fix。
