VSCode同名函数自动导入冲突是因为语言服务按解析顺序优先选用首个匹配符号，导致误导lodash而非lodash-es或本地debounce.ts；需检查tsconfig包含范围、路径别名配置，并重启TS服务器生效。
同名函数自动导入冲突的典型现象
当你在 TypeScript 或 JavaScript 项目中输入一个函数名（比如 debounce），VSCode 自动弹出多个同名建议，点击后却插入了错误路径的导入语句——例如从 lodash 导入，而你实际想用的是 lodash-es 或项目本地 src/utils/debounce.ts。更糟的是，保存时 ESLint 可能报 import/no-duplicates，或运行时报 Cannot resolve module。
为什么 VSCode 会选错导入路径
VSCode 的自动导入（Auto Import）不靠“猜”，而是依赖语言服务返回的符号定义位置。当多个同名函数存在于不同模块时，它只取第一个被解析到的——顺序由以下因素决定：
-
tsconfig.json中"include"和"exclude"范围是否覆盖了你期望的源文件 - 第三方包是否带完整类型声明（
lodash有，但某些精简版如lodash-es可能缺失或路径映射异常） - 项目中是否存在未启用的路径别名（如
@utils/debounce），但jsconfig.json没配"baseUrl"和"paths" - 多个语言服务器同时激活（比如 Volar + Vue Official 插件共存），各自注册了同名符号
手动控制导入来源的实操方法
不要等 VSCode “自动选对”，直接干预它的候选列表：
- 触发自动导入前，先将光标停在你想导入的目标函数定义处（比如打开
src/utils/debounce.ts），再回到使用处按Ctrl+Space→ 这样语言服务会优先索引当前文件上下文 - 输入函数名后，**不要急着回车**，用方向键下拉候选列表，留意每项右侧图标：
?表示本地文件，?表示 node_modules，选对再按Tab或Enter - 如果正确选项始终不出现，检查该文件是否被
tsconfig.json的"exclude"错误排除（常见于误写"**/node_modules/**"却漏掉了"src/**/*"） - 对高频冲突函数（如
throttle,useRouter），可在jsconfig.json或tsconfig.json中显式配置路径映射，强制收敛引用：{ "compilerOptions": { "baseUrl": ".", "paths": { "debounce": ["src/utils/debounce"], "@utils/*": ["src/utils/*"] } } }
容易被忽略的关键点
最常卡住的地方不是配置，而是语言服务没真正加载你改过的 tsconfig.json。改完配置后，必须执行 Ctrl+Shift+P → 输入 TypeScript: Restart TS server，否则所有路径映射都无效。另外，如果你禁用了 typescript.preferences.includePackageJsonAutoImports，那来自 node_modules 的自动导入也会整体失效——这不是冲突，是主动关掉了功能。
