Auto Import仅自动插入缺失的import语句，不生成或导出模块；它响应快捷键补全可解析符号，但对Vue宏无效，且不处理路径别名或barrel文件自动生成。
Auto Import 不是“装了就自动导出模块”的工具——它只负责自动插入缺失的 import 语句，不生成、不导出、不重构模块结构。真正需要“自动导出”的场景，得靠手动配置或搭配其他机制。
Auto Import 实际能做什么、不能做什么
- 它在你键入一个未声明的变量（如
useRouter）时，自动补全并插入对应import行，前提是该符号在项目中可被 TypeScript/ESLint 解析到 - 它不会为你把当前文件里的函数/类自动加到
index.ts中导出，也不会根据目录结构自动生成 barrel 文件（index.ts） - 它默认只响应
Ctrl+Space或Alt+Enter触发，不是“保存即导出” - 在 Vue
<script setup></script>中，它对defineProps、defineEmits等宏无效，因为这些是编译期注入，非真实导入项
常见错误现象：
- 输入
ref后没弹出 import 提示 → 检查是否已安装@vue/runtime-core类型声明，且compilerOptions.types包含"vue" -
Auto Import插入了import { xxx } from 'xxx'，但路径是绝对路径（如@/utils）却报错 → 路径别名未被插件识别，需确认jsconfig.json中baseUrl和paths配置正确，并重载窗口
真正实现“自动导出模块”的可行路径
要让新写的工具函数、组件、类型等自动出现在 index.ts 导出列表里，目前没有开箱即用的插件能完全替代人工判断，但可组合以下方式降低维护成本：
- 使用
barrel-files插件（非官方，需手动安装）：右键目录 → “Generate Barrel File”，它会扫描子文件并生成带命名导出的index.ts；但不监听新增文件，需手动触发 - 配合
npm run build:barrel脚本 +ts-barrel或barrelsby工具：在package.json中定义命令，每次提交前跑一次，确保导出同步；缺点是需额外构建步骤，且无法实时反馈 - 在 VSCode 中启用
typescript.preferences.autoImportFileExcludePatterns，避免把测试文件、私有工具（如<strong>mocks</strong>）误导入 barrel - 若用 Vite，可借助
vite-plugin-barrel实现开发时动态生成，但注意它不写入磁盘，仅运行时生效，对 IDE 跳转支持有限
为什么别指望插件“全自动导出”
- 导出意图具有语义性：一个新写的
helpers.ts，你可能只想导出其中 2 个函数，而非全部；插件无法理解业务边界 - 循环依赖风险：自动把 A.ts 导入 B.ts，又让 B.ts 自动导出 A.ts，容易触发 TS 报错
Cycle in ES module resolution - 团队规范差异大：有的项目要求按功能分组导出（
export <em> from './date'; export </em> from './string';），有的要求扁平命名（export { formatDate, parseDate } from './date';），插件难以统一适配
最务实的做法是：把 Auto Import 当作“减少手输 import”的辅助，把 barrel 文件当作“需人工 Review 的契约入口”，中间那层“自动同步”留给 CI 脚本或 pre-commit hook 去做校验，而不是强求编辑器实时完成。
