VSCode自动导入默认选择最短子路径（如'react/cjs/react.development.js'），因语言服务按类型定义文件解析；可控方案仅两种：TS配置"moduleResolution": "bundler"（TS 5.0+）并确保包含合规exports，或依赖包自身exports声明，其他插件或paths映射均不可靠。
为什么自动导入总从子路径引入？
VSCode 默认的自动导入行为会尽可能选择最短、最具体的路径，比如你输入 useEffect，它可能生成 import { useEffect } from 'react/cjs/react.development.js' 或 import { useEffect } from 'react/src/react.js'——这不是 bug，而是语言服务根据类型定义文件（.d.ts）的解析结果。真正可控的“只从顶层模块导入”，必须靠 tsconfig.json 的 compilerOptions.moduleResolution 和 paths 配合约束，而非编辑器设置。
强制走顶层入口：配 moduleResolution: "bundler"
TypeScript 5.0+ 引入了 "bundler" 模式，它模拟 Webpack/Vite 的解析逻辑，优先匹配 package.json 中的 exports 或 main/types 字段，跳过内部子路径。这是目前唯一能稳定压制“深路径导入”的方式：
- 在项目根目录
tsconfig.json的compilerOptions中添加："moduleResolution": "bundler",<br>"allowSyntheticDefaultImports": true
- 确保目标包（如
react、lodash-es）有合规的package.json#exports；若无，该模式会 fallback 到"node16"行为 - 改完后必须运行命令面板中的
TypeScript: Restart TS server，否则不生效
paths 别名 + baseUrl 不是替代方案
有人想用 "@react/*": ["node_modules/react/*"] 这类 paths 映射来“劫持”导入路径，但这是无效的：
— 它只影响你手动写的 import 语句的跳转和补全，不影响自动导入的源路径选择
— 自动导入仍会按原始类型定义结构推导，paths 不参与 resolve 过程
— 反而可能造成路径循环或类型丢失，尤其在 node_modules 内部映射时
插件层拦截风险高，不推荐
像 Auto Import（steoates 版）这类插件提供 auto-import.filter.enabled 等开关，看似能过滤路径，但实际逻辑是静态扫描文件系统，无法感知模块语义层级。启用后常出现：
— 把 lodash-es 的 map 导入成 import map from 'lodash-es/map'（破坏 tree-shaking）
— 在 monorepo 中误导入本地未发布包的源码路径
— 与 Volar / Pylance 冲突，导致 Ctrl+. 失效
真正可靠的控制点只有两个：TS 的 moduleResolution: "bundler" + 包自身的 exports 声明。其他任何绕过语言服务原生机制的尝试，都会在升级、跨项目或协作时暴露一致性问题。
